DataTableCollection.Item[] Propriété

Définition

Espace de noms:

System.Data

Assembly:

System.Data.Common.dll

Obtient l'objet DataTable spécifié de la collection.

Surcharges

Item[Int32]	Obtient l’objet DataTable à l’index spécifié.
Item[String]	Obtient l'objet DataTable avec le nom spécifié.
Item[String, String]	Obtient l'objet DataTable avec le nom spécifié dans l'espace de noms spécifié.

Item[Int32]

Source:

DataTableCollection.cs

Obtient l’objet DataTable à l’index spécifié.

public:
 property System::Data::DataTable ^ default[int] { System::Data::DataTable ^ get(int index); };

public System.Data.DataTable this[int index] { get; }

member this.Item(int) : System.Data.DataTable

Default Public ReadOnly Property Item(index As Integer) As DataTable

Paramètres

index

Int32

Index de base zéro du DataTable à rechercher.

Valeur de propriété

DataTable

DataTable avec l’index spécifié ; sinonnull, si le n’existe DataTable pas.

Exceptions

IndexOutOfRangeException

La valeur d'index est supérieure au nombre d'éléments dans la collection.

Exemples

L’exemple suivant récupère un DataTable par son index.

private void GetDataTableByIndex()
{
   // presuming a DataGrid is displaying more than one table, get its DataSet.
   DataSet thisDataSet = (DataSet)DataGrid1.DataSource;
   // Get the DataTableCollection.
   DataTableCollection tablesCollection = thisDataSet.Tables;
   // Iterate through the collection to get each table name.
   for (int i = 0; i < tablesCollection.Count; i++)
      Console.WriteLine(tablesCollection[i].TableName);
}

Private Sub GetDataTableByIndex()
    ' Presuming a DataGrid is displaying more than one table, get its DataSet.
    Dim thisDataSet As DataSet = CType(DataGrid1.DataSource, DataSet)

    ' Get the DataTableCollection.
    Dim tablesCollection As DataTableCollection = thisDataSet.Tables

    ' Iterate through the collection to get each table name.
    Dim i As Integer
    For i = 0 To tablesCollection.Count - 1
       Console.WriteLine(tablesCollection(i).TableName)
    Next
End Sub

Remarques

Utilisez la Contains méthode pour déterminer si une table avec un index spécifique existe.

Si vous avez le nom d’une table, mais pas son index, utilisez la IndexOf méthode pour renvoyer l’index.

Voir aussi

• Contains(String)
• IndexOf(DataTable)
• DataTable

Item[String]

Source:

DataTableCollection.cs

Obtient l'objet DataTable avec le nom spécifié.

public:
 property System::Data::DataTable ^ default[System::String ^] { System::Data::DataTable ^ get(System::String ^ name); };

public System.Data.DataTable? this[string? name] { get; }

member this.Item(string) : System.Data.DataTable

Default Public ReadOnly Property Item(name As String) As DataTable

Paramètres

name

String

Nom du DataTable à rechercher.

Valeur de propriété

DataTable

DataTable portant le nom spécifié ; sinon, null si DataTable n'existe pas.

Exemples

L’exemple suivant récupère une seule table par nom à partir de .DataTableCollection

private void GetTableByName()
{
    // Presuming a DataGrid is displaying more than one table, get its DataSet.
    DataSet thisDataSet = (DataSet)DataGrid1.DataSource;

    // Get the DataTableCollection.
    DataTableCollection tablesCollection = thisDataSet.Tables;

    // Get a specific table by name.
    DataTable table = tablesCollection["Suppliers"];
    Console.WriteLine(table.TableName);
}

Private Sub GetTableByName()
    ' Presuming a DataGrid is displaying more than one table, 
    ' get its DataSet.
    Dim thisDataSet As DataSet = CType(DataGrid1.DataSource, DataSet)

    ' Get the DataTableCollection.
    Dim tablesCollection As DataTableCollection = thisDataSet.Tables

    ' Get a specific table by name.
    Dim table As DataTable = tablesCollection("Suppliers")
    Console.WriteLine(table.TableName)
End Sub

Remarques

S’il existe un DataTable nom qui correspond à la casse de la chaîne de recherche, il est retourné. Sinon, une recherche ne respectant pas la casse est effectuée, et si un DataTable nom correspondant à cette recherche est trouvé, il est retourné.

Utilisez la Contains méthode pour déterminer s’il existe une table avec un nom ou un index spécifique.

Item[String, String]

Source:

DataTableCollection.cs

Obtient l'objet DataTable avec le nom spécifié dans l'espace de noms spécifié.

public:
 property System::Data::DataTable ^ default[System::String ^, System::String ^] { System::Data::DataTable ^ get(System::String ^ name, System::String ^ tableNamespace); };

public System.Data.DataTable? this[string? name, string tableNamespace] { get; }

member this.Item(string * string) : System.Data.DataTable

Default Public ReadOnly Property Item(name As String, tableNamespace As String) As DataTable

Paramètres

name

String

Nom du DataTable à rechercher.

tableNamespace

String

Nom de l'espace de noms DataTable dans lequel rechercher.

Valeur de propriété

DataTable

DataTable portant le nom spécifié ; sinon, null si DataTable n'existe pas.