ErrorProvider.DataSource プロパティ

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

ErrorProvider.DataSource プロパティ

ErrorProvider が監視するデータ ソースを取得または設定します。

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

Visual Basic (宣言)

Public Property DataSource As
 Object

Visual Basic (使用法)

Dim instance As ErrorProvider
Dim value As Object

value = instance.DataSource

instance.DataSource = value

C#

public Object DataSource { get; set;
 }

C++

public:
property Object^ DataSource {
    Object^ get ();
    void set (Object^ value);
}

J#

/** @property */
public Object get_DataSource ()

/** @property */
public void set_DataSource (Object value)

JScript

public function get DataSource
 () : Object

public function set DataSource
 (value : Object)

プロパティ値
IList インターフェイスに基づく、エラーを監視させるためのデータ ソース。通常、これはエラーを監視させるための DataSet です。

解説

DataSource は、コントロールに結び付けたり、エラーを監視したりするデータ ソースです。DataSource は、IList を実装する任意のコレクションに設定できます。

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 名前空間
ErrorProvider.DataMember プロパティ
IList