ErrorProvider.DataMember-Eigenschaft

Ruft die zu überwachende Liste in einer Datenquelle ab oder legt diese fest.

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

Syntax

'Declaration
Public Property DataMember As String
'Usage
Dim instance As ErrorProvider
Dim value As String

value = instance.DataMember

instance.DataMember = value

public string DataMember { get; set; }

public:
property String^ DataMember {
    String^ get ();
    void set (String^ value);
}

/** @property */
public String get_DataMember ()

/** @property */
public void set_DataMember (String value)

public function get DataMember () : String

public function set DataMember (value : String)

Eigenschaftenwert

Die Zeichenfolge, die eine Liste in der Datenquelle darstellt, die von der zu überwachenden DataSource angegeben wird. In der Regel handelt es sich dabei um eine DataTable.

Hinweise

Der DataMember ist eine auf der DataSource basierende Navigationszeichenfolge.

Um Konflikte zur Laufzeit zu vermeiden, die beim Ändern der DataSource und des DataMember auftreten können, verwenden Sie BindToDataAndErrors, anstatt die DataSource und den DataMember einzeln festzulegen.

Beispiel

Im folgenden Codebeispiel wird gezeigt, wie der ErrorProvider mit einer DataSource und einem DataMember zum Anzeigen eines Datenfehlers verwendet wird.

Private Sub InitializeComponent()
    ' Standard control setup.
    '....                  
    ' You set the DataSource to a data set, and the DataMember to a table.
    errorProvider1.DataSource = dataSet1
    errorProvider1.DataMember = dataTable1.TableName
    errorProvider1.ContainerControl = Me
    errorProvider1.BlinkRate = 200
End Sub 'InitializeComponent
 '...
' Since the ErrorProvider control does not have a visible component,
' it does not need to be added to the form. 

Private Sub buttonSave_Click(ByVal sender As Object, ByVal e As System.EventArgs)
    ' Checks for a bad post code.
    Dim CustomersTable As DataTable
    CustomersTable = customersDataSet1.Tables("Customers")
    Dim row As DataRow
    For Each row In CustomersTable.Rows
        If Convert.ToBoolean(row("PostalCodeIsNull")) Then
            row.RowError = "The Customer details contain errors"
            row.SetColumnError("PostalCode", "Postal Code required")
        End If
    Next row
End Sub 'buttonSave_Click

private void InitializeComponent()
 {
     // Standard control setup.
     //....
     // You set the DataSource to a data set, and the DataMember to a table.
     errorProvider1.DataSource = dataSet1 ;
     errorProvider1.DataMember = dataTable1.TableName ;
     errorProvider1.ContainerControl = this ;
     errorProvider1.BlinkRate = 200 ;
     //...
     // Since the ErrorProvider control does not have a visible component,
     // it does not need to be added to the form. 
 }
 
 private void buttonSave_Click(object sender, System.EventArgs e)
 {
     // Checks for a bad post code.
     DataTable CustomersTable;
     CustomersTable = customersDataSet1.Tables["Customers"];
     foreach (DataRow row in (CustomersTable.Rows)) 
     {
         if (Convert.ToBoolean(row["PostalCodeIsNull"])) 
         {
             row.RowError="The Customer details contain errors";
             row.SetColumnError("PostalCode", "Postal Code required");
         } 
     } 
 }

private:
   void InitializeComponent()
   {
      
      // Standard control setup.
      //....
      // You set the DataSource to a data set, and the DataMember to a table.
      errorProvider1->DataSource = dataSet1;
      errorProvider1->DataMember = dataTable1->TableName;
      errorProvider1->ContainerControl = this;
      errorProvider1->BlinkRate = 200;
      
      //...
      // Since the ErrorProvider control does not have a visible component,
      // it does not need to be added to the form. 
   }


private:
   void buttonSave_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      
      // Checks for a bad post code.
      DataTable^ CustomersTable;
      CustomersTable = customersDataSet1->Tables[ "Customers" ];
      System::Collections::IEnumerator^ myEnum = (CustomersTable->Rows)->GetEnumerator();
      while ( myEnum->MoveNext() )
      {
         DataRow^ row = safe_cast<DataRow^>(myEnum->Current);
         if ( Convert::ToBoolean( row[ "PostalCodeIsNull" ] ) )
         {
            row->RowError = "The Customer details contain errors";
            row->SetColumnError( "PostalCode", "Postal Code required" );
         }
      }
   }

private void InitializeComponent()
{
    // Standard control setup.
    //....
    // You set the DataSource to a data set, and the DataMember 
    // to a table.
    errorProvider1.set_DataSource(dataSet1);
    errorProvider1.set_DataMember(dataTable1.get_TableName());
    errorProvider1.set_ContainerControl(this);
    errorProvider1.set_BlinkRate(200);
    //...
    // Since the ErrorProvider control does not have a visible component,
    // it does not need to be added to the form. 
} //InitializeComponent

protected void buttonSave_Click(Object sender, System.EventArgs e)
{
    // Checks for a bad post code.
    DataTable customersTable;
    customersTable = customersDataSet1.get_Tables().get_Item("Customers");
    for (int iCtr = 0; iCtr < customersTable.get_Rows().get_Count(); 
         iCtr++) {
        DataRow row = customersTable.get_Rows().get_Item(iCtr);
        if (Convert.ToBoolean(row.get_Item("PostalCodeIsNull"))) {
            row.set_RowError("The Customer details contain errors");
            row.SetColumnError("PostalCode", "Postal Code required");
        }
    }
} //buttonSave_Click

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

ErrorProvider-Klasse
ErrorProvider-Member
System.Windows.Forms-Namespace