ErrorProvider.DataMember プロパティ

.NET Framework クラス ライブラリ リファレンス

ErrorProvider.DataMember プロパティ

監視するデータ ソース内のリストを取得または設定します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Property DataMember As
 String

Visual Basic (使用法)

Dim instance As ErrorProvider
Dim value As String

value = instance.DataMember

instance.DataMember = value

C#

public string DataMember { get;
 set; }

C++

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

J#

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

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

JScript

public function get DataMember
 () : String

public function set DataMember
 (value : String)

プロパティ値
監視する DataSource によって指定されたデータ ソース内のリストを表す文字列。通常、これは DataTable となります。

解説

DataMember は、DataSource に基づくナビゲーション文字列です。

DataSource と DataMember を変更しても、実行時に競合が発生しないようにするには、DataSource と DataMember を個別に設定するのではなく、BindToDataAndErrors を使用する必要があります。

使用例

DataSource および DataMember と併せて ErrorProvider を使用し、データ エラーをユーザーに提示するコード例を次に示します。

Visual Basic

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

C#

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");
         } 
     } 
 }

C++

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"
 );
         }
      }
   }

J#

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

プラットフォーム

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

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
ErrorProvider クラス
ErrorProvider メンバ
System.Windows.Forms 名前空間