Lire en anglais

Partager via


DataTable.ReadXmlSchema Méthode

Définition

Lit un schéma XML dans le DataTable.

Surcharges

ReadXmlSchema(XmlReader)

Lit un schéma XML dans le DataTable à l'aide du XmlReader spécifié.

ReadXmlSchema(String)

Lit un schéma XML dans le DataTable à partir du fichier spécifié.

ReadXmlSchema(TextReader)

Lit un schéma XML dans le DataTable à l'aide du TextReader spécifié.

ReadXmlSchema(Stream)

Lit un schéma XML dans le DataTable à l'aide du flux de données spécifié.

Remarques

Utilisez la ReadXmlSchema méthode pour créer le schéma d’un DataTable. Le schéma comprend des définitions de table, de relation et de contrainte.

Pour écrire un schéma dans un document XML, utilisez la WriteXmlSchema méthode .

Le schéma XML est interprété conformément à la norme XSD.

La ReadXmlSchema méthode est généralement appelée avant d’appeler la ReadXml méthode utilisée pour remplir le DataTable.

ReadXmlSchema(XmlReader)

Source:
DataTable.cs
Source:
DataTable.cs
Source:
DataTable.cs

Lit un schéma XML dans le DataTable à l'aide du XmlReader spécifié.

C#
public void ReadXmlSchema (System.Xml.XmlReader? reader);
C#
public void ReadXmlSchema (System.Xml.XmlReader reader);

Paramètres

reader
XmlReader

XmlReader utilisé pour lire les informations de schéma.

Exemples

L’application console suivante crée un nouveau DataTableet écrit le schéma de cette table dans un MemoryStream. Ensuite, l’exemple crée un nouveau DataTable et lit son schéma à partir du schéma XML enregistré, en utilisant un XmlTextReader (qui hérite de XmlReader) comme source.

C#
private static void DemonstrateReadWriteXMLSchemaWithReader()
{
    DataTable table = CreateTestTable("XmlDemo");
    PrintSchema(table, "Original table");

    // Write the schema to XML in a memory stream.
    System.IO.MemoryStream xmlStream =
        new System.IO.MemoryStream();
    table.WriteXmlSchema(xmlStream);

    // Rewind the memory stream.
    xmlStream.Position = 0;

    DataTable newTable = new DataTable();
    System.Xml.XmlTextReader reader =
        new System.Xml.XmlTextReader(xmlStream);
    newTable.ReadXmlSchema(reader);

    // Print out values in the table.
    PrintSchema(newTable, "New table");
}

private static DataTable CreateTestTable(string tableName)
{
    // Create a test DataTable with two columns and a few rows.
    DataTable table = new DataTable(tableName);
    DataColumn column = new DataColumn("id", typeof(System.Int32));
    column.AutoIncrement = true;
    table.Columns.Add(column);

    column = new DataColumn("item", typeof(System.String));
    table.Columns.Add(column);

    // Add ten rows.
    DataRow row;
    for (int i = 0; i <= 9; i++)
    {
        row = table.NewRow();
        row["item"] = "item " + i;
        table.Rows.Add(row);
    }

    table.AcceptChanges();
    return table;
}

private static void PrintSchema(DataTable table, string label)
{
    // Display the schema of the supplied DataTable:
    Console.WriteLine(label);
    foreach (DataColumn column in table.Columns)
    {
        Console.WriteLine("\t{0}: {1}", column.ColumnName,
            column.DataType.Name);
    }
    Console.WriteLine();
}

Remarques

Utilisez la ReadXmlSchema méthode pour créer le schéma d’un DataTable. Le schéma comprend des définitions de table, de relation et de contrainte.

Pour écrire un schéma dans un document XML, utilisez la WriteXmlSchema méthode .

Le schéma XML est interprété conformément à la norme XSD.

Une altération des données peut se produire si les types msdata :DataType et xs :type ne correspondent pas. Aucune exception ne sera levée.

La ReadXmlSchema méthode est généralement appelée avant d’appeler la ReadXml méthode utilisée pour remplir le DataTable.

Notes

La façon de créer une relation imbriquée à l’aide d’un schéma XML consiste à avoir des éléments imbriqués implicites. En outre, la relation imbriquée peut être re-câblée pour utiliser des noms de colonnes explicites. Il est obligatoire que les éléments soient implicitement imbriqués pour que les DataTables correspondants participent à une relation imbriquée.

Voir aussi

S’applique à

.NET 9 et autres versions
Produit Versions
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

ReadXmlSchema(String)

Source:
DataTable.cs
Source:
DataTable.cs
Source:
DataTable.cs

Lit un schéma XML dans le DataTable à partir du fichier spécifié.

C#
public void ReadXmlSchema (string fileName);

Paramètres

fileName
String

Nom du fichier à partir duquel lire les informations de schéma.

Exemples

L’application console suivante crée un nouveau DataTableet écrit le schéma de cette table dans un fichier. Ensuite, l’exemple crée un nouveau DataTable et lit son schéma à partir du schéma XML enregistré, en utilisant le fichier comme source.

C#
private static void DemonstrateReadWriteXMLSchemaWithFile()
{
    DataTable table = CreateTestTable("XmlDemo");
    PrintSchema(table, "Original table");

    // Write the schema to XML in a file.
    string xmlFile = "C:\\SchemaDemo.xml";
    table.WriteXmlSchema(xmlFile);

    DataTable newTable = new DataTable();
    newTable.ReadXmlSchema(xmlFile);

    // Print out values in the table.
    PrintSchema(newTable, "New table");
}

private static DataTable CreateTestTable(string tableName)
{
    // Create a test DataTable with two columns and a few rows.
    DataTable table = new DataTable(tableName);
    DataColumn column = new DataColumn("id", typeof(System.Int32));
    column.AutoIncrement = true;
    table.Columns.Add(column);

    column = new DataColumn("item", typeof(System.String));
    table.Columns.Add(column);

    // Add ten rows.
    DataRow row;
    for (int i = 0; i <= 9; i++)
    {
        row = table.NewRow();
        row["item"] = "item " + i;
        table.Rows.Add(row);
    }

    table.AcceptChanges();
    return table;
}

private static void PrintSchema(DataTable table, string label)
{
    // Display the schema of the supplied DataTable:
    Console.WriteLine(label);
    foreach (DataColumn column in table.Columns)
    {
        Console.WriteLine("\t{0}: {1}", column.ColumnName,
            column.DataType.Name);
    }
    Console.WriteLine();
}

Remarques

Utilisez la ReadXmlSchema méthode pour créer le schéma d’un DataTable. Le schéma comprend des définitions de table, de relation et de contrainte.

Pour écrire un schéma dans un document XML, utilisez la WriteXmlSchema méthode .

Le schéma XML est interprété conformément à la norme XSD.

Une altération des données peut se produire si les types msdata :DataType et xs :type ne correspondent pas. Aucune exception ne sera levée.

La ReadXmlSchema méthode est généralement appelée avant d’appeler la ReadXml méthode utilisée pour remplir le DataTable.

Pour créer une relation imbriquée à l’aide d’un schéma XML, utilisez des éléments imbriqués implicites. Vous pouvez également reconfigurer la relation imbriquée pour utiliser des noms de colonnes explicites. Les éléments doivent être implicitement imbriqués pour que les DataTables correspondants participent à une relation imbriquée.

Voir aussi

S’applique à

.NET 9 et autres versions
Produit Versions
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

ReadXmlSchema(TextReader)

Source:
DataTable.cs
Source:
DataTable.cs
Source:
DataTable.cs

Lit un schéma XML dans le DataTable à l'aide du TextReader spécifié.

C#
public void ReadXmlSchema (System.IO.TextReader? reader);
C#
public void ReadXmlSchema (System.IO.TextReader reader);

Paramètres

reader
TextReader

TextReader utilisé pour lire les informations de schéma.

Exemples

L’application console suivante crée un nouveau DataTableet écrit le schéma de cette table dans un MemoryStream. Ensuite, l’exemple crée un nouveau DataTable et lit son schéma à partir du schéma XML enregistré, en utilisant un StreamReader (qui hérite de TextReader) comme source.

C#
private static void DemonstrateReadWriteXMLSchemaWithReader()
{
    DataTable table = CreateTestTable("XmlDemo");
    PrintSchema(table, "Original table");

    // Write the schema to XML in a memory stream.
    System.IO.MemoryStream xmlStream = new System.IO.MemoryStream();
    table.WriteXmlSchema(xmlStream);

    // Rewind the memory stream.
    xmlStream.Position = 0;

    DataTable newTable = new DataTable();
    System.IO.StreamReader reader =
        new System.IO.StreamReader(xmlStream);
    newTable.ReadXmlSchema(reader);

    // Print out values in the table.
    PrintSchema(newTable, "New table");
}

private static DataTable CreateTestTable(string tableName)
{
    // Create a test DataTable with two columns and a few rows.
    DataTable table = new DataTable(tableName);
    DataColumn column = new DataColumn("id", typeof(System.Int32));
    column.AutoIncrement = true;
    table.Columns.Add(column);

    column = new DataColumn("item", typeof(System.String));
    table.Columns.Add(column);

    // Add ten rows.
    DataRow row;
    for (int i = 0; i <= 9; i++)
    {
        row = table.NewRow();
        row["item"] = "item " + i;
        table.Rows.Add(row);
    }

    table.AcceptChanges();
    return table;
}

private static void PrintSchema(DataTable table, string label)
{
    // Display the schema of the supplied DataTable:
    Console.WriteLine(label);
    foreach (DataColumn column in table.Columns)
    {
        Console.WriteLine("\t{0}: {1}",
            column.ColumnName, column.DataType.Name);
    }
    Console.WriteLine();
}

Remarques

Utilisez la ReadXmlSchema méthode pour créer le schéma d’un DataTable. Le schéma comprend des définitions de table, de relation et de contrainte.

Pour écrire un schéma dans un document XML, utilisez la WriteXmlSchema méthode .

Le schéma XML est interprété conformément à la norme XSD.

Une altération des données peut se produire si les types msdata :DataType et xs :type ne correspondent pas. Aucune exception ne sera levée.

La ReadXmlSchema méthode est généralement appelée avant d’appeler la ReadXml méthode utilisée pour remplir le DataTable.

Pour créer une relation imbriquée à l’aide d’un schéma XML, utilisez des éléments imbriqués implicites. Vous pouvez également reconfigurer la relation imbriquée pour utiliser des noms de colonnes explicites. Les éléments doivent être implicitement imbriqués pour que les DataTables correspondants participent à une relation imbriquée.

Voir aussi

S’applique à

.NET 9 et autres versions
Produit Versions
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

ReadXmlSchema(Stream)

Source:
DataTable.cs
Source:
DataTable.cs
Source:
DataTable.cs

Lit un schéma XML dans le DataTable à l'aide du flux de données spécifié.

C#
public void ReadXmlSchema (System.IO.Stream? stream);
C#
public void ReadXmlSchema (System.IO.Stream stream);

Paramètres

stream
Stream

Flux de données utilisé pour lire le schéma.

Exemples

L’application console suivante crée un nouveau DataTableet écrit le schéma de cette table dans un MemoryStream. Ensuite, l’exemple crée un nouveau DataTable et lit son schéma à partir du schéma XML enregistré.

C#
private static void DemonstrateReadWriteXMLSchemaWithStream()
{
    DataTable table = CreateTestTable("XmlDemo");
    PrintSchema(table, "Original table");

    // Write the schema to XML in a memory stream.
    System.IO.MemoryStream xmlStream = new System.IO.MemoryStream();
    table.WriteXmlSchema(xmlStream);

    // Rewind the memory stream.
    xmlStream.Position = 0;

    DataTable newTable = new DataTable();
    newTable.ReadXmlSchema(xmlStream);

    // Print out values in the table.
    PrintSchema(newTable, "New table");
}

private static DataTable CreateTestTable(string tableName)
{
    // Create a test DataTable with two columns and a few rows.
    DataTable table = new DataTable(tableName);
    DataColumn column = new DataColumn("id", typeof(System.Int32));
    column.AutoIncrement = true;
    table.Columns.Add(column);

    column = new DataColumn("item", typeof(System.String));
    table.Columns.Add(column);

    // Add ten rows.
    DataRow row;
    for (int i = 0; i <= 9; i++)
    {
        row = table.NewRow();
        row["item"] = "item " + i;
        table.Rows.Add(row);
    }

    table.AcceptChanges();
    return table;
}

private static void PrintSchema(DataTable table, string label)
{
    // Display the schema of the supplied DataTable:
    Console.WriteLine(label);
    foreach (DataColumn column in table.Columns)
    {
        Console.WriteLine("\t{0}: {1}", column.ColumnName,
            column.DataType.Name);
    }
    Console.WriteLine();
}

Remarques

Utilisez la ReadXmlSchema méthode pour créer le schéma d’un DataTable. Le schéma comprend des définitions de table, de relation et de contrainte.

Pour écrire un schéma dans un document XML, utilisez la WriteXmlSchema méthode .

Le schéma XML est interprété conformément à la norme XSD.

Une altération des données peut se produire si les types msdata :DataType et xs :type ne correspondent pas. Aucune exception ne sera levée.

La ReadXmlSchema méthode est généralement appelée avant d’appeler la ReadXml méthode utilisée pour remplir le DataTable.

Pour créer une relation imbriquée à l’aide d’un schéma XML, utilisez des éléments imbriqués implicites. Vous pouvez également configurer la relation imbriquée pour utiliser des noms de colonnes explicites. Les éléments doivent être implicitement imbriqués pour que les DataTables correspondants participent à une relation imbriquée.

Voir aussi

S’applique à

.NET 9 et autres versions
Produit Versions
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1