DataGridColumnStyle.ReadOnly-Eigenschaft

Ruft einen Wert ab, der angibt, ob die Daten in der Spalte bearbeitet werden können, oder legt diesen fest.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
Public Overridable Property ReadOnly As Boolean
'Usage
Dim instance As DataGridColumnStyle
Dim value As Boolean

value = instance.ReadOnly

instance.ReadOnly = value

public virtual bool ReadOnly { get; set; }

public:
virtual property bool ReadOnly {
    bool get ();
    void set (bool value);
}

/** @property */
public boolean get_ReadOnly ()

/** @property */
public void set_ReadOnly (boolean value)

public function get ReadOnly () : boolean

public function set ReadOnly (value : boolean)

Eigenschaftenwert

true, wenn die Daten nicht bearbeitet werden können, andernfalls false.

Hinweise

Eine Spalte muss schreibgeschützt sein, wenn sie einen Primärschlüssel enthält oder der enthaltene Wert automatisch generiert wird (z. B. wenn die AutoIncrement-Eigenschaft des DataColumn-Objekts auf true festgelegt ist).

Ähnliche schreibgeschützte Eigenschaften sind auch in anderen Klassen vorhanden, wobei jede Eigenschaft eine bessere Steuerung des Datenzugriffs ermöglicht. Beispielsweise kann das System.Windows.Forms.DataGrid-Steuerelement über dessen ReadOnly-Eigenschaft auf den schreibgeschützten Modus festgelegt werden. Der DataGridTableStyle besitzt ebenfalls eine ReadOnly-Eigenschaft, und die DataColumn-Klasse verfügt über eine ReadOnly-Eigenschaft zum Einschränken von Datenaktualisierungen.

Beispiel

Im folgenden Codebeispiel wird die ReadOnly-Eigenschaft des DataGridColumnStyle-Objekts auf den Wert der ReadOnly-Eigenschaft des DataColumn-Objekts festgelegt.

Private Sub SetReadOnly()
    Dim myColumn As DataGridColumnStyle
    Dim myDataColumns As DataColumnCollection
    ' Get the columns for a table bound to a DataGrid.
    myDataColumns = dataSet1.Tables("Suppliers").Columns
    Dim dataColumn As DataColumn
    For Each dataColumn In myDataColumns
        dataGrid1.TableStyles(0).GridColumnStyles(dataColumn.ColumnName).ReadOnly = dataColumn.ReadOnly
    Next dataColumn
End Sub 'SetReadOnly

private void SetReadOnly()
{
    DataColumnCollection myDataColumns;
    // Get the columns for a table bound to a DataGrid.
    myDataColumns = dataSet1.Tables["Suppliers"].Columns;
    foreach(DataColumn dataColumn in myDataColumns)
    {
        dataGrid1.TableStyles[0].GridColumnStyles[dataColumn.ColumnName].ReadOnly = dataColumn.ReadOnly;
    }
}
 

void SetReadOnly()
{
   DataColumnCollection^ myDataColumns;
   
   // Get the columns for a table bound to a DataGrid.
   myDataColumns = dataSet1->Tables[ "Suppliers" ]->Columns;
   System::Collections::IEnumerator^ myEnum = myDataColumns->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      DataColumn^ dataColumn = safe_cast<DataColumn^>(myEnum->Current);
      dataGrid1->TableStyles[ 0 ]->GridColumnStyles[ dataColumn->ColumnName ]->ReadOnly = dataColumn->ReadOnly;
   }
}

private void SetReadOnly()
{
    DataColumnCollection myDataColumns;
    // Get the columns for a table bound to a DataGrid.
    myDataColumns = dataSet1.get_Tables().get_Item("Suppliers").
        get_Columns();
    DataColumn dataColumn;
    for (int iCtr = 0; iCtr < myDataColumns.get_Count(); iCtr++) {
        dataColumn = myDataColumns.get_Item(iCtr);
        dataGrid1.get_TableStyles().get_Item(0).get_GridColumnStyles().
            get_Item(dataColumn.get_ColumnName()).
            set_ReadOnly(dataColumn.get_ReadOnly());
    }
} //SetReadOnly

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

DataGridColumnStyle-Klasse
DataGridColumnStyle-Member
System.Windows.Forms-Namespace
AutoIncrement
DataColumn