DataTable.WriteXml Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Schreibt den aktuellen Inhalt des DataTable XML-Codes.
Überlädt
| Name | Beschreibung |
|---|---|
| WriteXml(TextWriter, Boolean) |
Schreibt den aktuellen Inhalt des DataTable xml-Codes mithilfe des angegebenen TextWriter. Um die Daten für die Tabelle und alle untergeordneten Elemente zu speichern, legen Sie den |
| WriteXml(TextWriter, XmlWriteMode) |
Schreibt die aktuellen Daten und optional das Schema für die DataTable Verwendung der angegebenen TextWriter und XmlWriteMode. Um das Schema zu schreiben, legen Sie den Wert für den |
| WriteXml(String, XmlWriteMode) |
Schreibt die aktuellen Daten und optional das Schema für die DataTable Verwendung der angegebenen Datei und XmlWriteMode. Um das Schema zu schreiben, legen Sie den Wert für den |
| WriteXml(Stream, XmlWriteMode) |
Schreibt die aktuellen Daten und optional das Schema für die DataTable angegebene Datei mithilfe der angegebenen XmlWriteModeDatei. Um das Schema zu schreiben, legen Sie den Wert für den |
| WriteXml(XmlWriter, Boolean) |
Schreibt den aktuellen Inhalt des DataTable xml-Codes mithilfe des angegebenen XmlWriter. |
| WriteXml(XmlWriter, XmlWriteMode) |
Schreibt die aktuellen Daten und optional das Schema für die DataTable Verwendung der angegebenen XmlWriter und XmlWriteMode. Um das Schema zu schreiben, legen Sie den Wert für den |
| WriteXml(Stream, XmlWriteMode, Boolean) |
Schreibt die aktuellen Daten und optional das Schema für die DataTable angegebene Datei mithilfe der angegebenen XmlWriteModeDatei. Um das Schema zu schreiben, legen Sie den Wert für den |
| WriteXml(TextWriter, XmlWriteMode, Boolean) |
Schreibt die aktuellen Daten und optional das Schema für die DataTable Verwendung der angegebenen TextWriter und XmlWriteMode. Um das Schema zu schreiben, legen Sie den Wert für den |
| WriteXml(String, Boolean) |
Schreibt den aktuellen Inhalt des DataTable XML-Codes mithilfe der angegebenen Datei. Um die Daten für die Tabelle und alle untergeordneten Elemente zu speichern, legen Sie den |
| WriteXml(Stream, Boolean) |
Schreibt den aktuellen Inhalt des DataTable xml-Codes mithilfe des angegebenen Stream. Um die Daten für die Tabelle und alle untergeordneten Elemente zu speichern, legen Sie den |
| WriteXml(XmlWriter, XmlWriteMode, Boolean) |
Schreibt die aktuellen Daten und optional das Schema für die DataTable Verwendung der angegebenen XmlWriter und XmlWriteMode. Um das Schema zu schreiben, legen Sie den Wert für den |
| WriteXml(String) |
Schreibt den aktuellen Inhalt des DataTable XML-Codes mithilfe der angegebenen Datei. |
| WriteXml(TextWriter) |
Schreibt den aktuellen Inhalt des DataTable xml-Codes mithilfe des angegebenen TextWriter. |
| WriteXml(Stream) |
Schreibt den aktuellen Inhalt des DataTable xml-Codes mithilfe des angegebenen Stream. |
| WriteXml(String, XmlWriteMode, Boolean) |
Schreibt die aktuellen Daten und optional das Schema für die DataTable Verwendung der angegebenen Datei und XmlWriteMode. Um das Schema zu schreiben, legen Sie den Wert für den |
| WriteXml(XmlWriter) |
Schreibt den aktuellen Inhalt des DataTable xml-Codes mithilfe des angegebenen XmlWriter. |
Beispiele
Die folgende Konsolenanwendung erstellt zwei DataTable Instanzen, fügt jedes einer DataSethinzu, erstellt eine DataRelation Beziehung zu den beiden Tabellen und verwendet dann die WriteXml Methode, um die Daten in der übergeordneten Tabelle in eine zu TextWriterschreiben. Das Beispiel veranschaulicht das Verhalten beim Festlegen des writeHierarchy Parameters auf die einzelnen Werte.
Note
In diesem Beispiel wird gezeigt, wie Sie eine der überladenen Versionen von WriteXml verwenden. Weitere Beispiele, die verfügbar sein können, finden Sie in den einzelnen Überladungsthemen.
static void Main()
{
DataSet ds = new DataSet();
DataTable customerTable = GetCustomers();
DataTable orderTable = GetOrders();
ds.Tables.Add(customerTable);
ds.Tables.Add(orderTable);
ds.Relations.Add("CustomerOrder",
new DataColumn[] { customerTable.Columns[0] },
new DataColumn[] { orderTable.Columns[1] }, true);
System.IO.StringWriter writer = new System.IO.StringWriter();
customerTable.WriteXml(writer, XmlWriteMode.WriteSchema, false);
PrintOutput(writer, "Customer table, without hierarchy");
writer = new System.IO.StringWriter();
customerTable.WriteXml(writer, XmlWriteMode.WriteSchema, true);
PrintOutput(writer, "Customer table, with hierarchy");
Console.WriteLine("Press any key to continue.");
Console.ReadKey();
}
private static DataTable GetCustomers()
{
// Create sample Customers table, in order
// to demonstrate the behavior of the DataTableReader.
DataTable table = new DataTable();
// Create two columns, ID and Name.
DataColumn idColumn = table.Columns.Add("ID", typeof(System.Int32));
table.Columns.Add("Name", typeof(System.String));
// Set the ID column as the primary key column.
table.PrimaryKey = new DataColumn[] { idColumn };
table.Rows.Add(new object[] { 1, "Mary" });
table.Rows.Add(new object[] { 2, "Andy" });
table.Rows.Add(new object[] { 3, "Peter" });
table.Rows.Add(new object[] { 4, "Russ" });
table.AcceptChanges();
return table;
}
private static DataTable GetOrders()
{
// Create sample Customers table, in order
// to demonstrate the behavior of the DataTableReader.
DataTable table = new DataTable();
// Create three columns; OrderID, CustomerID, and OrderDate.
table.Columns.Add(new DataColumn("OrderID", typeof(System.Int32)));
table.Columns.Add(new DataColumn("CustomerID", typeof(System.Int32)));
table.Columns.Add(new DataColumn("OrderDate", typeof(System.DateTime)));
// Set the OrderID column as the primary key column.
table.PrimaryKey = new DataColumn[] { table.Columns[0] };
table.Rows.Add(new object[] { 1, 1, "12/2/2003" });
table.Rows.Add(new object[] { 2, 1, "1/3/2004" });
table.Rows.Add(new object[] { 3, 2, "11/13/2004" });
table.Rows.Add(new object[] { 4, 3, "5/16/2004" });
table.Rows.Add(new object[] { 5, 3, "5/22/2004" });
table.Rows.Add(new object[] { 6, 4, "6/15/2004" });
table.AcceptChanges();
return table;
}
private static void PrintOutput(System.IO.TextWriter writer, string caption)
{
Console.WriteLine("==============================");
Console.WriteLine(caption);
Console.WriteLine("==============================");
Console.WriteLine(writer.ToString());
}
Sub Main()
Dim ds As New DataSet
Dim customerTable As DataTable = GetCustomers()
Dim orderTable As DataTable = GetOrders()
ds.Tables.Add(customerTable)
ds.Tables.Add(orderTable)
ds.Relations.Add("CustomerOrder", _
New DataColumn() {customerTable.Columns(0)}, _
New DataColumn() {orderTable.Columns(1)}, True)
Dim writer As New System.IO.StringWriter
customerTable.WriteXml(writer, XmlWriteMode.WriteSchema, False)
PrintOutput(writer, "Customer table, without hierarchy")
writer = New System.IO.StringWriter
customerTable.WriteXml(writer, XmlWriteMode.WriteSchema, True)
PrintOutput(writer, "Customer table, with hierarchy")
Console.WriteLine("Press any key to continue.")
Console.ReadKey()
End Sub
Private Function GetOrders() As DataTable
' Create sample Customers table, in order
' to demonstrate the behavior of the DataTableReader.
Dim table As New DataTable
' Create three columns, OrderID, CustomerID, and OrderDate.
table.Columns.Add(New DataColumn("OrderID", GetType(System.Int32)))
table.Columns.Add(New DataColumn("CustomerID", GetType(System.Int32)))
table.Columns.Add(New DataColumn("OrderDate", GetType(System.DateTime)))
' Set the OrderID column as the primary key column.
table.PrimaryKey = New DataColumn() {table.Columns(0)}
table.Rows.Add(New Object() {1, 1, #12/2/2003#})
table.Rows.Add(New Object() {2, 1, #1/3/2004#})
table.Rows.Add(New Object() {3, 2, #11/13/2004#})
table.Rows.Add(New Object() {4, 3, #5/16/2004#})
table.Rows.Add(New Object() {5, 3, #5/22/2004#})
table.Rows.Add(New Object() {6, 4, #6/15/2004#})
table.AcceptChanges()
Return table
End Function
Private Function GetCustomers() As DataTable
' Create sample Customers table, in order
' to demonstrate the behavior of the DataTableReader.
Dim table As New DataTable
' Create two columns, ID and Name.
Dim idColumn As DataColumn = table.Columns.Add("ID", _
GetType(System.Int32))
table.Columns.Add("Name", GetType(System.String))
' Set the ID column as the primary key column.
table.PrimaryKey = New DataColumn() {idColumn}
table.Rows.Add(New Object() {1, "Mary"})
table.Rows.Add(New Object() {2, "Andy"})
table.Rows.Add(New Object() {3, "Peter"})
table.Rows.Add(New Object() {4, "Russ"})
table.AcceptChanges()
Return table
End Function
Private Sub PrintOutput( _
ByVal writer As System.IO.TextWriter, ByVal caption As String)
Console.WriteLine("==============================")
Console.WriteLine(caption)
Console.WriteLine("==============================")
Console.WriteLine(writer.ToString())
End Sub
Im Beispiel wird die folgende Ausgabe im Konsolenfenster angezeigt:
==============================
Customer table, without hierarchy
==============================
<NewDataSet>
<xs:schema id="NewDataSet" xmlns="" xmlns:xs="http://www.w3.org/2001/XMLSchema
" xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">
<xs:element name="NewDataSet" msdata:IsDataSet="true" msdata:MainDataTable="Table1">
<xs:complexType>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element name="Table1">
<xs:complexType>
<xs:sequence>
<xs:element name="ID" type="xs:int" />
<xs:element name="Name" type="xs:string" minOccurs="0" />
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:choice>
</xs:complexType>
<xs:unique name="Constraint1" msdata:PrimaryKey="true">
<xs:selector xpath=".//Table1" />
<xs:field xpath="ID" />
</xs:unique>
</xs:element>
</xs:schema>
<Table1>
<ID>1</ID>
<Name>Mary</Name>
</Table1>
<Table1>
<ID>2</ID>
<Name>Andy</Name>
</Table1>
<Table1>
<ID>3</ID>
<Name>Peter</Name>
</Table1>
<Table1>
<ID>4</ID>
<Name>Russ</Name>
</Table1>
</NewDataSet>
==============================
Customer table, with hierarchy
==============================
<NewDataSet>
<xs:schema id="NewDataSet" xmlns="" xmlns:xs="http://www.w3.org/2001/XMLSchema
" xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">
<xs:element name="NewDataSet" msdata:IsDataSet="true" msdata:MainDataTable="Table1">
<xs:complexType>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element name="Table1">
<xs:complexType>
<xs:sequence>
<xs:element name="ID" type="xs:int" />
<xs:element name="Name" type="xs:string" minOccurs="0" />
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="Table2">
<xs:complexType>
<xs:sequence>
<xs:element name="OrderID" type="xs:int" />
<xs:element name="CustomerID" type="xs:int" minOccurs="0" />
<xs:element name="OrderDate" type="xs:dateTime" minOccurs="0" />
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:choice>
</xs:complexType>
<xs:unique name="Constraint1" msdata:PrimaryKey="true">
<xs:selector xpath=".//Table1" />
<xs:field xpath="ID" />
</xs:unique>
<xs:unique name="Table2_Constraint1" msdata:ConstraintName="Constraint1" m
sdata:PrimaryKey="true">
<xs:selector xpath=".//Table2" />
<xs:field xpath="OrderID" />
</xs:unique>
<xs:keyref name="CustomerOrder" refer="Constraint1">
<xs:selector xpath=".//Table2" />
<xs:field xpath="CustomerID" />
</xs:keyref>
</xs:element>
</xs:schema>
<Table1>
<ID>1</ID>
<Name>Mary</Name>
</Table1>
<Table1>
<ID>2</ID>
<Name>Andy</Name>
</Table1>
<Table1>
<ID>3</ID>
<Name>Peter</Name>
</Table1>
<Table1>
<ID>4</ID>
<Name>Russ</Name>
</Table1>
<Table2>
<OrderID>1</OrderID>
<CustomerID>1</CustomerID>
<OrderDate>2003-12-02T00:00:00.0000000-08:00</OrderDate>
</Table2>
<Table2>
<OrderID>2</OrderID>
<CustomerID>1</CustomerID>
<OrderDate>2004-01-03T00:00:00.0000000-08:00</OrderDate>
</Table2>
<Table2>
<OrderID>3</OrderID>
<CustomerID>2</CustomerID>
<OrderDate>2004-11-13T00:00:00.0000000-08:00</OrderDate>
</Table2>
<Table2>
<OrderID>4</OrderID>
<CustomerID>3</CustomerID>
<OrderDate>2004-05-16T00:00:00.0000000-07:00</OrderDate>
</Table2>
<Table2>
<OrderID>5</OrderID>
<CustomerID>3</CustomerID>
<OrderDate>2004-05-22T00:00:00.0000000-07:00</OrderDate>
</Table2>
<Table2>
<OrderID>6</OrderID>
<CustomerID>4</CustomerID>
<OrderDate>2004-06-15T00:00:00.0000000-07:00</OrderDate>
</Table2>
</NewDataSet>
Hinweise
Die WriteXml Methode bietet eine Möglichkeit, nur Daten oder sowohl Daten als auch Schema aus einem DataTable XML-Dokument zu schreiben, während die WriteXmlSchema Methode nur das Schema schreibt. Verwenden Sie zum Schreiben von Daten und Schemas eine der Überladungen, die den XmlWriteMode Parameter enthalten, und legen Sie den Wert auf WriteSchema.
Beachten Sie, dass das gleiche für die ReadXml bzw ReadXmlSchema . methoden gilt. Verwenden Sie die ReadXml Methode, um XML-Daten oder sowohl Schema- als auch Daten in die DataTableXml-Datei zu lesen. Verwenden Sie die ReadXmlSchema Methode, um nur das Schema zu lesen.
Note
Es InvalidOperationException wird ein Fehler ausgelöst, wenn ein Spaltentyp im DataRow Lese- oder Schreibvorgang für Implementierungen IDynamicMetaObjectProvider und nicht implementiert IXmlSerializablewird.
WriteXml(TextWriter, Boolean)
Schreibt den aktuellen Inhalt des DataTable xml-Codes mithilfe des angegebenen TextWriter. Um die Daten für die Tabelle und alle untergeordneten Elemente zu speichern, legen Sie den writeHierarchy Parameter auf true.
public:
void WriteXml(System::IO::TextWriter ^ writer, bool writeHierarchy);
public void WriteXml(System.IO.TextWriter writer, bool writeHierarchy);
member this.WriteXml : System.IO.TextWriter * bool -> unit
Public Sub WriteXml (writer As TextWriter, writeHierarchy As Boolean)
Parameter
- writer
- TextWriter
Der TextWriter Inhalt, mit dem der Inhalt geschrieben werden soll.
- writeHierarchy
- Boolean
Wenn true, schreiben Sie den Inhalt der aktuellen Tabelle und alle untergeordneten Elemente. Wenn false (der Standardwert) die Daten nur für die aktuelle Tabelle schreiben.
Beispiele
Die folgende Konsolenanwendung erstellt zwei DataTable Instanzen, fügt jedes einer DataSethinzu, erstellt eine DataRelation Beziehung zu den beiden Tabellen und verwendet dann die WriteXml Methode, um die Daten in der übergeordneten Tabelle in eine zu TextWriterschreiben. Das Beispiel veranschaulicht das Verhalten beim Festlegen des writeHierarchy Parameters auf true.
static void Main()
{
DataSet ds = new DataSet();
DataTable customerTable = GetCustomers();
DataTable orderTable = GetOrders();
ds.Tables.Add(customerTable);
ds.Tables.Add(orderTable);
ds.Relations.Add("CustomerOrder",
new DataColumn[] { customerTable.Columns[0] },
new DataColumn[] { orderTable.Columns[1] }, true);
System.IO.StringWriter writer = new System.IO.StringWriter();
customerTable.WriteXml(writer, true);
PrintOutput(writer, "Customer table, with hierarchy");
Console.WriteLine("Press any key to continue.");
Console.ReadKey();
}
private static DataTable GetCustomers()
{
// Create sample Customers table, in order
// to demonstrate the behavior of the DataTableReader.
DataTable table = new DataTable();
// Create two columns, ID and Name.
DataColumn idColumn = table.Columns.Add("ID", typeof(System.Int32));
table.Columns.Add("Name", typeof(System.String));
// Set the ID column as the primary key column.
table.PrimaryKey = new DataColumn[] { idColumn };
table.Rows.Add(new object[] { 1, "Mary" });
table.Rows.Add(new object[] { 2, "Andy" });
table.Rows.Add(new object[] { 3, "Peter" });
table.Rows.Add(new object[] { 4, "Russ" });
table.AcceptChanges();
return table;
}
private static DataTable GetOrders()
{
// Create sample Customers table, in order
// to demonstrate the behavior of the DataTableReader.
DataTable table = new DataTable();
// Create three columns; OrderID, CustomerID, and OrderDate.
table.Columns.Add(new DataColumn("OrderID", typeof(System.Int32)));
table.Columns.Add(new DataColumn("CustomerID", typeof(System.Int32)));
table.Columns.Add(new DataColumn("OrderDate", typeof(System.DateTime)));
// Set the OrderID column as the primary key column.
table.PrimaryKey = new DataColumn[] { table.Columns[0] };
table.Rows.Add(new object[] { 1, 1, "12/2/2003" });
table.Rows.Add(new object[] { 2, 1, "1/3/2004" });
table.Rows.Add(new object[] { 3, 2, "11/13/2004" });
table.Rows.Add(new object[] { 4, 3, "5/16/2004" });
table.Rows.Add(new object[] { 5, 3, "5/22/2004" });
table.Rows.Add(new object[] { 6, 4, "6/15/2004" });
table.AcceptChanges();
return table;
}
private static void PrintOutput(System.IO.TextWriter stream,
string caption)
{
Console.WriteLine("==============================");
Console.WriteLine(caption);
Console.WriteLine("==============================");
Console.WriteLine(stream.ToString());
}
Sub Main()
Dim ds As New DataSet
Dim customerTable As DataTable = GetCustomers()
Dim orderTable As DataTable = GetOrders()
ds.Tables.Add(customerTable)
ds.Tables.Add(orderTable)
ds.Relations.Add("CustomerOrder", _
New DataColumn() {customerTable.Columns(0)}, _
New DataColumn() {orderTable.Columns(1)}, True)
Dim writer As New System.IO.StringWriter
customerTable.WriteXml(writer, True)
PrintOutput(writer, "Customer table, with hierarchy")
Console.WriteLine("Press any key to continue.")
Console.ReadKey()
End Sub
Private Function GetOrders() As DataTable
' Create sample Customers table, in order
' to demonstrate the behavior of the DataTableReader.
Dim table As New DataTable
' Create three columns, OrderID, CustomerID, and OrderDate.
table.Columns.Add(New DataColumn("OrderID", GetType(System.Int32)))
table.Columns.Add(New DataColumn("CustomerID", GetType(System.Int32)))
table.Columns.Add(New DataColumn("OrderDate", GetType(System.DateTime)))
' Set the OrderID column as the primary key column.
table.PrimaryKey = New DataColumn() {table.Columns(0)}
table.Rows.Add(New Object() {1, 1, #12/2/2003#})
table.Rows.Add(New Object() {2, 1, #1/3/2004#})
table.Rows.Add(New Object() {3, 2, #11/13/2004#})
table.Rows.Add(New Object() {4, 3, #5/16/2004#})
table.Rows.Add(New Object() {5, 3, #5/22/2004#})
table.Rows.Add(New Object() {6, 4, #6/15/2004#})
table.AcceptChanges()
Return table
End Function
Private Function GetCustomers() As DataTable
' Create sample Customers table, in order
' to demonstrate the behavior of the DataTableReader.
Dim table As New DataTable
' Create two columns, ID and Name.
Dim idColumn As DataColumn = table.Columns.Add("ID", _
GetType(System.Int32))
table.Columns.Add("Name", GetType(System.String))
' Set the ID column as the primary key column.
table.PrimaryKey = New DataColumn() {idColumn}
table.Rows.Add(New Object() {1, "Mary"})
table.Rows.Add(New Object() {2, "Andy"})
table.Rows.Add(New Object() {3, "Peter"})
table.Rows.Add(New Object() {4, "Russ"})
table.AcceptChanges()
Return table
End Function
Private Sub PrintOutput( _
ByVal stream As System.IO.TextWriter, ByVal caption As String)
Console.WriteLine("==============================")
Console.WriteLine(caption)
Console.WriteLine("==============================")
Console.WriteLine(stream.ToString())
End Sub
Hinweise
Die WriteXml Methode bietet eine Möglichkeit, nur Daten oder sowohl Daten als auch Schema aus einem DataTable XML-Dokument zu schreiben, während die WriteXmlSchema Methode nur das Schema schreibt. Verwenden Sie zum Schreiben von Daten und Schemas eine der Überladungen, die den XmlWriteMode Parameter enthalten, und legen Sie den Wert auf WriteSchema.
Normalerweise schreibt die WriteXml Methode die Daten nur für die aktuelle Tabelle. Rufen Sie die Methode auf, um die Daten für die aktuelle Tabelle und alle untergeordneten verknüpften Tabellen zu schreiben, wobei der writeHierarchy Parameter auf . true festgelegt ist.
Note
Es InvalidOperationException wird ein Fehler ausgelöst, wenn ein Spaltentyp im DataRow Lese- oder Schreibvorgang für Implementierungen IDynamicMetaObjectProvider und nicht implementiert IXmlSerializablewird.
Weitere Informationen
Gilt für:
WriteXml(TextWriter, XmlWriteMode)
Schreibt die aktuellen Daten und optional das Schema für die DataTable Verwendung der angegebenen TextWriter und XmlWriteMode. Um das Schema zu schreiben, legen Sie den Wert für den mode Parameter auf WriteSchema.
public:
void WriteXml(System::IO::TextWriter ^ writer, System::Data::XmlWriteMode mode);
public void WriteXml(System.IO.TextWriter writer, System.Data.XmlWriteMode mode);
member this.WriteXml : System.IO.TextWriter * System.Data.XmlWriteMode -> unit
Public Sub WriteXml (writer As TextWriter, mode As XmlWriteMode)
Parameter
- writer
- TextWriter
Die TextWriter zum Schreiben des Dokuments verwendete Datei.
- mode
- XmlWriteMode
Einer der XmlWriteMode Werte.
Hinweise
Die WriteXml Methode bietet eine Möglichkeit, nur Daten oder sowohl Daten als auch Schema aus einem DataTable XML-Dokument zu schreiben, während die WriteXmlSchema Methode nur das Schema schreibt. Verwenden Sie zum Schreiben von Daten und Schemas eine der Überladungen, die den XmlWriteMode Parameter enthalten, und legen Sie den Wert auf WriteSchema.
Beachten Sie, dass das gleiche für die ReadXml bzw ReadXmlSchema . methoden gilt. Verwenden Sie die ReadXml Methode, um XML-Daten oder sowohl Schema- als auch Daten in die DataTableXml-Datei zu lesen. Verwenden Sie die ReadXmlSchema Methode, um nur das Schema zu lesen.
Note
Es InvalidOperationException wird ein Fehler ausgelöst, wenn ein Spaltentyp im DataRow Lese- oder Schreibvorgang für Implementierungen IDynamicMetaObjectProvider und nicht implementiert IXmlSerializablewird.
Weitere Informationen
Gilt für:
WriteXml(String, XmlWriteMode)
Schreibt die aktuellen Daten und optional das Schema für die DataTable Verwendung der angegebenen Datei und XmlWriteMode. Um das Schema zu schreiben, legen Sie den Wert für den mode Parameter auf WriteSchema.
public:
void WriteXml(System::String ^ fileName, System::Data::XmlWriteMode mode);
public void WriteXml(string fileName, System.Data.XmlWriteMode mode);
member this.WriteXml : string * System.Data.XmlWriteMode -> unit
Public Sub WriteXml (fileName As String, mode As XmlWriteMode)
Parameter
- fileName
- String
Der Name der Datei, in die die Daten geschrieben werden.
- mode
- XmlWriteMode
Einer der XmlWriteMode Werte.
Hinweise
Die WriteXml Methode bietet eine Möglichkeit, nur Daten oder sowohl Daten als auch Schema aus einem DataTable XML-Dokument zu schreiben, während die WriteXmlSchema Methode nur das Schema schreibt. Verwenden Sie zum Schreiben von Daten und Schemas eine der Überladungen, die den XmlWriteMode Parameter enthalten, und legen Sie den Wert auf WriteSchema.
Beachten Sie, dass das gleiche für die ReadXml bzw ReadXmlSchema . methoden gilt. Verwenden Sie die ReadXml Methode, um XML-Daten oder sowohl Schema- als auch Daten in die DataTableXml-Datei zu lesen. Verwenden Sie die ReadXmlSchema Methode, um nur das Schema zu lesen.
Note
Es InvalidOperationException wird ein Fehler ausgelöst, wenn ein Spaltentyp im DataRow Lese- oder Schreibvorgang für Implementierungen IDynamicMetaObjectProvider und nicht implementiert IXmlSerializablewird.
Weitere Informationen
Gilt für:
WriteXml(Stream, XmlWriteMode)
Schreibt die aktuellen Daten und optional das Schema für die DataTable angegebene Datei mithilfe der angegebenen XmlWriteModeDatei. Um das Schema zu schreiben, legen Sie den Wert für den mode Parameter auf WriteSchema.
public:
void WriteXml(System::IO::Stream ^ stream, System::Data::XmlWriteMode mode);
public void WriteXml(System.IO.Stream stream, System.Data.XmlWriteMode mode);
member this.WriteXml : System.IO.Stream * System.Data.XmlWriteMode -> unit
Public Sub WriteXml (stream As Stream, mode As XmlWriteMode)
Parameter
- stream
- Stream
Der Datenstrom, in den die Daten geschrieben werden.
- mode
- XmlWriteMode
Einer der XmlWriteMode Werte.
Hinweise
Die WriteXml Methode bietet eine Möglichkeit, nur Daten oder sowohl Daten als auch Schema aus einem DataTable XML-Dokument zu schreiben, während die WriteXmlSchema Methode nur das Schema schreibt. Verwenden Sie zum Schreiben von Daten und Schemas eine der Überladungen, die den XmlWriteMode Parameter enthalten, und legen Sie den Wert auf WriteSchema.
Beachten Sie, dass das gleiche für die ReadXml bzw ReadXmlSchema . methoden gilt. Verwenden Sie die ReadXml Methode, um XML-Daten oder sowohl Schema- als auch Daten in die DataTableXml-Datei zu lesen. Verwenden Sie die ReadXmlSchema Methode, um nur das Schema zu lesen.
Note
Es InvalidOperationException wird ein Fehler ausgelöst, wenn ein Spaltentyp im DataRow Lese- oder Schreibvorgang für Implementierungen IDynamicMetaObjectProvider und nicht implementiert IXmlSerializablewird.
Weitere Informationen
Gilt für:
WriteXml(XmlWriter, Boolean)
public:
void WriteXml(System::Xml::XmlWriter ^ writer, bool writeHierarchy);
public void WriteXml(System.Xml.XmlWriter writer, bool writeHierarchy);
member this.WriteXml : System.Xml.XmlWriter * bool -> unit
Public Sub WriteXml (writer As XmlWriter, writeHierarchy As Boolean)
Parameter
- writeHierarchy
- Boolean
Wenn true, schreiben Sie den Inhalt der aktuellen Tabelle und alle untergeordneten Elemente. Wenn false (der Standardwert) die Daten nur für die aktuelle Tabelle schreiben.
Hinweise
Die WriteXml Methode bietet eine Möglichkeit, nur Daten oder sowohl Daten als auch Schema aus einem DataTable XML-Dokument zu schreiben, während die WriteXmlSchema Methode nur das Schema schreibt. Verwenden Sie zum Schreiben von Daten und Schemas eine der Überladungen, die den XmlWriteMode Parameter enthalten, und legen Sie den Wert auf WriteSchema.
Beachten Sie, dass das gleiche für die ReadXml bzw ReadXmlSchema . methoden gilt. Verwenden Sie die ReadXml Methode, um XML-Daten oder sowohl Schema- als auch Daten in die DataTableXml-Datei zu lesen. Verwenden Sie die ReadXmlSchema Methode, um nur das Schema zu lesen.
Normalerweise schreibt die WriteXml Methode die Daten nur für die aktuelle Tabelle. Rufen Sie die Methode auf, um die Daten für die aktuelle Tabelle und deren gesamte absteigende Tabellen zu schreiben, wobei der writeHierarchy Parameter auf . true festgelegt ist.
Note
Es InvalidOperationException wird ein Fehler ausgelöst, wenn ein Spaltentyp im DataRow Lese- oder Schreibvorgang für Implementierungen IDynamicMetaObjectProvider und nicht implementiert IXmlSerializablewird.
Weitere Informationen
Gilt für:
WriteXml(XmlWriter, XmlWriteMode)
Schreibt die aktuellen Daten und optional das Schema für die DataTable Verwendung der angegebenen XmlWriter und XmlWriteMode. Um das Schema zu schreiben, legen Sie den Wert für den mode Parameter auf WriteSchema.
public:
void WriteXml(System::Xml::XmlWriter ^ writer, System::Data::XmlWriteMode mode);
public void WriteXml(System.Xml.XmlWriter writer, System.Data.XmlWriteMode mode);
member this.WriteXml : System.Xml.XmlWriter * System.Data.XmlWriteMode -> unit
Public Sub WriteXml (writer As XmlWriter, mode As XmlWriteMode)
Parameter
- mode
- XmlWriteMode
Einer der XmlWriteMode Werte.
Hinweise
Die WriteXml Methode bietet eine Möglichkeit, nur Daten oder sowohl Daten als auch Schema aus einem DataTable XML-Dokument zu schreiben, während die WriteXmlSchema Methode nur das Schema schreibt. Verwenden Sie zum Schreiben von Daten und Schemas eine der Überladungen, die den XmlWriteMode Parameter enthalten, und legen Sie den Wert auf WriteSchema.
Beachten Sie, dass das gleiche für die ReadXml bzw ReadXmlSchema . methoden gilt. Verwenden Sie die ReadXml Methode, um XML-Daten oder sowohl Schema- als auch Daten in die DataTableXml-Datei zu lesen. Verwenden Sie die ReadXmlSchema Methode, um nur das Schema zu lesen.
Note
Es InvalidOperationException wird ein Fehler ausgelöst, wenn ein Spaltentyp im DataRow Lese- oder Schreibvorgang für Implementierungen IDynamicMetaObjectProvider und nicht implementiert IXmlSerializablewird.
Weitere Informationen
Gilt für:
WriteXml(Stream, XmlWriteMode, Boolean)
Schreibt die aktuellen Daten und optional das Schema für die DataTable angegebene Datei mithilfe der angegebenen XmlWriteModeDatei. Um das Schema zu schreiben, legen Sie den Wert für den mode Parameter auf WriteSchema. Um die Daten für die Tabelle und alle untergeordneten Elemente zu speichern, legen Sie den writeHierarchy Parameter auf true.
public:
void WriteXml(System::IO::Stream ^ stream, System::Data::XmlWriteMode mode, bool writeHierarchy);
public void WriteXml(System.IO.Stream stream, System.Data.XmlWriteMode mode, bool writeHierarchy);
member this.WriteXml : System.IO.Stream * System.Data.XmlWriteMode * bool -> unit
Public Sub WriteXml (stream As Stream, mode As XmlWriteMode, writeHierarchy As Boolean)
Parameter
- stream
- Stream
Der Datenstrom, in den die Daten geschrieben werden.
- mode
- XmlWriteMode
Einer der XmlWriteMode Werte.
- writeHierarchy
- Boolean
Wenn true, schreiben Sie den Inhalt der aktuellen Tabelle und alle untergeordneten Elemente. Wenn false (der Standardwert) die Daten nur für die aktuelle Tabelle schreiben.
Hinweise
Die WriteXml Methode bietet eine Möglichkeit, nur Daten oder sowohl Daten als auch Schema aus einem DataTable XML-Dokument zu schreiben, während die WriteXmlSchema Methode nur das Schema schreibt. Verwenden Sie zum Schreiben von Daten und Schemas eine der Überladungen, die den XmlWriteMode Parameter enthalten, und legen Sie den Wert auf WriteSchema.
Beachten Sie, dass das gleiche für die ReadXml bzw ReadXmlSchema . methoden gilt. Verwenden Sie die ReadXml Methode, um XML-Daten oder sowohl Schema- als auch Daten in die DataTableXml-Datei zu lesen. Verwenden Sie die ReadXmlSchema Methode, um nur das Schema zu lesen.
Normalerweise speichert die WriteXml Methode Daten nur für die aktuelle Tabelle. Die WriteXml Methode bietet eine Möglichkeit, nur Daten oder sowohl Daten als auch Schema aus einem DataTable XML-Dokument zu schreiben, während die WriteXmlSchema Methode nur das Schema schreibt. Verwenden Sie zum Schreiben von Daten und Schemas eine der Überladungen, die den XmlWriteMode Parameter enthalten, und legen Sie den Wert auf WriteSchema.
Beachten Sie, dass das gleiche für die ReadXml bzw ReadXmlSchema . methoden gilt. Verwenden Sie die ReadXml Methode, um XML-Daten oder sowohl Schema- als auch Daten in die DataTableXml-Datei zu lesen. Verwenden Sie die ReadXmlSchema Methode, um nur das Schema zu lesen.
Normalerweise schreibt die WriteXml Methode die Daten nur für die aktuelle Tabelle. Rufen Sie die Methode auf, um die Daten für die aktuelle Tabelle und alle untergeordneten tabellen zu schreiben, auf die die writeHierarchy Methode festgelegt ist true.
Note
Es InvalidOperationException wird ein Fehler ausgelöst, wenn ein Spaltentyp im DataRow Lese- oder Schreibvorgang für Implementierungen IDynamicMetaObjectProvider und nicht implementiert IXmlSerializablewird.
Weitere Informationen
Gilt für:
WriteXml(TextWriter, XmlWriteMode, Boolean)
Schreibt die aktuellen Daten und optional das Schema für die DataTable Verwendung der angegebenen TextWriter und XmlWriteMode. Um das Schema zu schreiben, legen Sie den Wert für den mode Parameter auf WriteSchema. Um die Daten für die Tabelle und alle untergeordneten Elemente zu speichern, legen Sie den writeHierarchy Parameter auf true.
public:
void WriteXml(System::IO::TextWriter ^ writer, System::Data::XmlWriteMode mode, bool writeHierarchy);
public void WriteXml(System.IO.TextWriter writer, System.Data.XmlWriteMode mode, bool writeHierarchy);
member this.WriteXml : System.IO.TextWriter * System.Data.XmlWriteMode * bool -> unit
Public Sub WriteXml (writer As TextWriter, mode As XmlWriteMode, writeHierarchy As Boolean)
Parameter
- writer
- TextWriter
Die TextWriter zum Schreiben des Dokuments verwendete Datei.
- mode
- XmlWriteMode
Einer der XmlWriteMode Werte.
- writeHierarchy
- Boolean
Wenn true, schreiben Sie den Inhalt der aktuellen Tabelle und alle untergeordneten Elemente. Wenn false (der Standardwert) die Daten nur für die aktuelle Tabelle schreiben.
Beispiele
Die folgende Konsolenanwendung erstellt zwei DataTable Instanzen, fügt jedes einer DataSethinzu, erstellt eine DataRelation Beziehung zu den beiden Tabellen und verwendet dann die WriteXml Methode, um die Daten in der übergeordneten Tabelle in eine zu TextWriterschreiben. Das Beispiel veranschaulicht das Verhalten beim Festlegen des writeHierarchy Parameters auf die einzelnen Werte.
static void Main()
{
DataSet ds = new DataSet();
DataTable customerTable = GetCustomers();
DataTable orderTable = GetOrders();
ds.Tables.Add(customerTable);
ds.Tables.Add(orderTable);
ds.Relations.Add("CustomerOrder",
new DataColumn[] { customerTable.Columns[0] },
new DataColumn[] { orderTable.Columns[1] }, true);
System.IO.StringWriter writer = new System.IO.StringWriter();
customerTable.WriteXml(writer, XmlWriteMode.WriteSchema, false);
PrintOutput(writer, "Customer table, without hierarchy");
writer = new System.IO.StringWriter();
customerTable.WriteXml(writer, XmlWriteMode.WriteSchema, true);
PrintOutput(writer, "Customer table, with hierarchy");
Console.WriteLine("Press any key to continue.");
Console.ReadKey();
}
private static DataTable GetCustomers()
{
// Create sample Customers table, in order
// to demonstrate the behavior of the DataTableReader.
DataTable table = new DataTable();
// Create two columns, ID and Name.
DataColumn idColumn = table.Columns.Add("ID", typeof(System.Int32));
table.Columns.Add("Name", typeof(System.String));
// Set the ID column as the primary key column.
table.PrimaryKey = new DataColumn[] { idColumn };
table.Rows.Add(new object[] { 1, "Mary" });
table.Rows.Add(new object[] { 2, "Andy" });
table.Rows.Add(new object[] { 3, "Peter" });
table.Rows.Add(new object[] { 4, "Russ" });
table.AcceptChanges();
return table;
}
private static DataTable GetOrders()
{
// Create sample Customers table, in order
// to demonstrate the behavior of the DataTableReader.
DataTable table = new DataTable();
// Create three columns; OrderID, CustomerID, and OrderDate.
table.Columns.Add(new DataColumn("OrderID", typeof(System.Int32)));
table.Columns.Add(new DataColumn("CustomerID", typeof(System.Int32)));
table.Columns.Add(new DataColumn("OrderDate", typeof(System.DateTime)));
// Set the OrderID column as the primary key column.
table.PrimaryKey = new DataColumn[] { table.Columns[0] };
table.Rows.Add(new object[] { 1, 1, "12/2/2003" });
table.Rows.Add(new object[] { 2, 1, "1/3/2004" });
table.Rows.Add(new object[] { 3, 2, "11/13/2004" });
table.Rows.Add(new object[] { 4, 3, "5/16/2004" });
table.Rows.Add(new object[] { 5, 3, "5/22/2004" });
table.Rows.Add(new object[] { 6, 4, "6/15/2004" });
table.AcceptChanges();
return table;
}
private static void PrintOutput(System.IO.TextWriter writer,
string caption)
{
Console.WriteLine("==============================");
Console.WriteLine(caption);
Console.WriteLine("==============================");
Console.WriteLine(writer.ToString());
}
Sub Main()
Dim ds As New DataSet
Dim customerTable As DataTable = GetCustomers()
Dim orderTable As DataTable = GetOrders()
ds.Tables.Add(customerTable)
ds.Tables.Add(orderTable)
ds.Relations.Add("CustomerOrder", _
New DataColumn() {customerTable.Columns(0)}, _
New DataColumn() {orderTable.Columns(1)}, True)
Dim writer As New System.IO.StringWriter
customerTable.WriteXml(writer, XmlWriteMode.WriteSchema, False)
PrintOutput(writer, "Customer table, without hierarchy")
writer = New System.IO.StringWriter
customerTable.WriteXml(writer, XmlWriteMode.WriteSchema, True)
PrintOutput(writer, "Customer table, with hierarchy")
Console.WriteLine("Press any key to continue.")
Console.ReadKey()
End Sub
Private Function GetOrders() As DataTable
' Create sample Customers table, in order
' to demonstrate the behavior of the DataTableReader.
Dim table As New DataTable
' Create three columns, OrderID, CustomerID, and OrderDate.
table.Columns.Add(New DataColumn("OrderID", GetType(System.Int32)))
table.Columns.Add(New DataColumn("CustomerID", GetType(System.Int32)))
table.Columns.Add(New DataColumn("OrderDate", GetType(System.DateTime)))
' Set the OrderID column as the primary key column.
table.PrimaryKey = New DataColumn() {table.Columns(0)}
table.Rows.Add(New Object() {1, 1, #12/2/2003#})
table.Rows.Add(New Object() {2, 1, #1/3/2004#})
table.Rows.Add(New Object() {3, 2, #11/13/2004#})
table.Rows.Add(New Object() {4, 3, #5/16/2004#})
table.Rows.Add(New Object() {5, 3, #5/22/2004#})
table.Rows.Add(New Object() {6, 4, #6/15/2004#})
table.AcceptChanges()
Return table
End Function
Private Function GetCustomers() As DataTable
' Create sample Customers table, in order
' to demonstrate the behavior of the DataTableReader.
Dim table As New DataTable
' Create two columns, ID and Name.
Dim idColumn As DataColumn = table.Columns.Add("ID", _
GetType(System.Int32))
table.Columns.Add("Name", GetType(System.String))
' Set the ID column as the primary key column.
table.PrimaryKey = New DataColumn() {idColumn}
table.Rows.Add(New Object() {1, "Mary"})
table.Rows.Add(New Object() {2, "Andy"})
table.Rows.Add(New Object() {3, "Peter"})
table.Rows.Add(New Object() {4, "Russ"})
table.AcceptChanges()
Return table
End Function
Private Sub PrintOutput( _
ByVal writer As System.IO.TextWriter, ByVal caption As String)
Console.WriteLine("==============================")
Console.WriteLine(caption)
Console.WriteLine("==============================")
Console.WriteLine(writer.ToString())
End Sub
Im Beispiel wird die folgende Ausgabe im Konsolenfenster angezeigt:
==============================
Customer table, without hierarchy
==============================
<NewDataSet>
<xs:schema id="NewDataSet" xmlns="" xmlns:xs="http://www.w3.org/2001/XMLSchema
" xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">
<xs:element name="NewDataSet" msdata:IsDataSet="true" msdata:MainDataTable="Table1">
<xs:complexType>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element name="Table1">
<xs:complexType>
<xs:sequence>
<xs:element name="ID" type="xs:int" />
<xs:element name="Name" type="xs:string" minOccurs="0" />
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:choice>
</xs:complexType>
<xs:unique name="Constraint1" msdata:PrimaryKey="true">
<xs:selector xpath=".//Table1" />
<xs:field xpath="ID" />
</xs:unique>
</xs:element>
</xs:schema>
<Table1>
<ID>1</ID>
<Name>Mary</Name>
</Table1>
<Table1>
<ID>2</ID>
<Name>Andy</Name>
</Table1>
<Table1>
<ID>3</ID>
<Name>Peter</Name>
</Table1>
<Table1>
<ID>4</ID>
<Name>Russ</Name>
</Table1>
</NewDataSet>
==============================
Customer table, with hierarchy
==============================
<NewDataSet>
<xs:schema id="NewDataSet" xmlns="" xmlns:xs="http://www.w3.org/2001/XMLSchema
" xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">
<xs:element name="NewDataSet" msdata:IsDataSet="true" msdata:MainDataTable="Table1">
<xs:complexType>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element name="Table1">
<xs:complexType>
<xs:sequence>
<xs:element name="ID" type="xs:int" />
<xs:element name="Name" type="xs:string" minOccurs="0" />
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="Table2">
<xs:complexType>
<xs:sequence>
<xs:element name="OrderID" type="xs:int" />
<xs:element name="CustomerID" type="xs:int" minOccurs="0" />
<xs:element name="OrderDate" type="xs:dateTime" minOccurs="0" />
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:choice>
</xs:complexType>
<xs:unique name="Constraint1" msdata:PrimaryKey="true">
<xs:selector xpath=".//Table1" />
<xs:field xpath="ID" />
</xs:unique>
<xs:unique name="Table2_Constraint1" msdata:ConstraintName="Constraint1" m
sdata:PrimaryKey="true">
<xs:selector xpath=".//Table2" />
<xs:field xpath="OrderID" />
</xs:unique>
<xs:keyref name="CustomerOrder" refer="Constraint1">
<xs:selector xpath=".//Table2" />
<xs:field xpath="CustomerID" />
</xs:keyref>
</xs:element>
</xs:schema>
<Table1>
<ID>1</ID>
<Name>Mary</Name>
</Table1>
<Table1>
<ID>2</ID>
<Name>Andy</Name>
</Table1>
<Table1>
<ID>3</ID>
<Name>Peter</Name>
</Table1>
<Table1>
<ID>4</ID>
<Name>Russ</Name>
</Table1>
<Table2>
<OrderID>1</OrderID>
<CustomerID>1</CustomerID>
<OrderDate>2003-12-02T00:00:00.0000000-08:00</OrderDate>
</Table2>
<Table2>
<OrderID>2</OrderID>
<CustomerID>1</CustomerID>
<OrderDate>2004-01-03T00:00:00.0000000-08:00</OrderDate>
</Table2>
<Table2>
<OrderID>3</OrderID>
<CustomerID>2</CustomerID>
<OrderDate>2004-11-13T00:00:00.0000000-08:00</OrderDate>
</Table2>
<Table2>
<OrderID>4</OrderID>
<CustomerID>3</CustomerID>
<OrderDate>2004-05-16T00:00:00.0000000-07:00</OrderDate>
</Table2>
<Table2>
<OrderID>5</OrderID>
<CustomerID>3</CustomerID>
<OrderDate>2004-05-22T00:00:00.0000000-07:00</OrderDate>
</Table2>
<Table2>
<OrderID>6</OrderID>
<CustomerID>4</CustomerID>
<OrderDate>2004-06-15T00:00:00.0000000-07:00</OrderDate>
</Table2>
</NewDataSet>
Hinweise
Die WriteXml Methode bietet eine Möglichkeit, nur Daten oder sowohl Daten als auch Schema aus einem DataTable XML-Dokument zu schreiben, während die WriteXmlSchema Methode nur das Schema schreibt. Verwenden Sie zum Schreiben von Daten und Schemas eine der Überladungen, die den XmlWriteMode Parameter enthalten, und legen Sie den Wert auf WriteSchema.
Beachten Sie, dass das gleiche für die ReadXml bzw ReadXmlSchema . methoden gilt. Verwenden Sie die ReadXml Methode, um XML-Daten oder sowohl Schema- als auch Daten in die DataTableXml-Datei zu lesen. Verwenden Sie die ReadXmlSchema Methode, um nur das Schema zu lesen.
Normalerweise speichert die WriteXml Methode Daten nur für die aktuelle Tabelle. Die WriteXml Methode bietet eine Möglichkeit, nur Daten oder sowohl Daten als auch Schema aus einem DataTable XML-Dokument zu schreiben, während die WriteXmlSchema Methode nur das Schema schreibt. Verwenden Sie zum Schreiben von Daten und Schemas eine der Überladungen, die den XmlWriteMode Parameter enthalten, und legen Sie den Wert auf WriteSchema.
Beachten Sie, dass das gleiche für die ReadXml bzw ReadXmlSchema . methoden gilt. Verwenden Sie die ReadXml Methode, um XML-Daten oder sowohl Schema- als auch Daten in die DataTableXml-Datei zu lesen. Verwenden Sie die ReadXmlSchema Methode, um nur das Schema zu lesen.
Normalerweise schreibt die WriteXml Methode die Daten nur für die aktuelle Tabelle. Rufen Sie die Methode auf, um die Daten für die aktuelle Tabelle und alle untergeordneten tabellen zu schreiben, auf die die writeHierarchy Methode festgelegt ist true.
Note
Es InvalidOperationException wird ein Fehler ausgelöst, wenn ein Spaltentyp im DataRow Lese- oder Schreibvorgang für Implementierungen IDynamicMetaObjectProvider und nicht implementiert IXmlSerializablewird.
Weitere Informationen
Gilt für:
WriteXml(String, Boolean)
Schreibt den aktuellen Inhalt des DataTable XML-Codes mithilfe der angegebenen Datei. Um die Daten für die Tabelle und alle untergeordneten Elemente zu speichern, legen Sie den writeHierarchy Parameter auf true.
public:
void WriteXml(System::String ^ fileName, bool writeHierarchy);
public void WriteXml(string fileName, bool writeHierarchy);
member this.WriteXml : string * bool -> unit
Public Sub WriteXml (fileName As String, writeHierarchy As Boolean)
Parameter
- fileName
- String
Die Datei, in die die XML-Daten geschrieben werden sollen.
- writeHierarchy
- Boolean
Wenn true, schreiben Sie den Inhalt der aktuellen Tabelle und alle untergeordneten Elemente. Wenn false (der Standardwert) die Daten nur für die aktuelle Tabelle schreiben.
Hinweise
Die WriteXml Methode bietet eine Möglichkeit, nur Daten oder sowohl Daten als auch Schema aus einem DataTable XML-Dokument zu schreiben, während die WriteXmlSchema Methode nur das Schema schreibt. Verwenden Sie zum Schreiben von Daten und Schemas eine der Überladungen, die den XmlWriteMode Parameter enthalten, und legen Sie den Wert auf WriteSchema.
Beachten Sie, dass das gleiche für die ReadXml bzw ReadXmlSchema . methoden gilt. Verwenden Sie die ReadXml Methode, um XML-Daten oder sowohl Schema- als auch Daten in die DataTableXml-Datei zu lesen. Verwenden Sie die ReadXmlSchema Methode, um nur das Schema zu lesen.
Normalerweise schreibt die WriteXml Methode die Daten nur für die aktuelle Tabelle. Rufen Sie die Methode auf, um die Daten für die aktuelle Tabelle und alle untergeordneten tabellen zu schreiben, auf die die writeHierarchy Methode festgelegt ist true.
Note
Es InvalidOperationException wird ein Fehler ausgelöst, wenn ein Spaltentyp im DataRow Lese- oder Schreibvorgang für Implementierungen IDynamicMetaObjectProvider und nicht implementiert IXmlSerializablewird.
Weitere Informationen
Gilt für:
WriteXml(Stream, Boolean)
public:
void WriteXml(System::IO::Stream ^ stream, bool writeHierarchy);
public void WriteXml(System.IO.Stream stream, bool writeHierarchy);
member this.WriteXml : System.IO.Stream * bool -> unit
Public Sub WriteXml (stream As Stream, writeHierarchy As Boolean)
Parameter
- stream
- Stream
Der Datenstrom, in den die Daten geschrieben werden.
- writeHierarchy
- Boolean
Wenn true, schreiben Sie den Inhalt der aktuellen Tabelle und alle untergeordneten Elemente. Wenn false (der Standardwert) die Daten nur für die aktuelle Tabelle schreiben.
Hinweise
Verwenden Sie die WriteXmlSchema Methode, um das Schema für ein DataTable XML-Dokument zu schreiben. Das Schema enthält Tabellen-, Beziehungs- und Einschränkungsdefinitionen.
Das XML-Schema wird mit dem XSD-Standard geschrieben.
Verwenden Sie die WriteXml Methode, um die Daten in ein XML-Dokument zu schreiben.
Normalerweise schreibt die WriteXml Methode die Daten nur für die aktuelle Tabelle. Rufen Sie die Methode auf, um die Daten für die aktuelle Tabelle und alle untergeordneten tabellen zu schreiben, auf die die writeHierarchy Methode festgelegt ist true.
Note
Es InvalidOperationException wird ein Fehler ausgelöst, wenn ein Spaltentyp im DataRow Lese- oder Schreibvorgang für Implementierungen IDynamicMetaObjectProvider und nicht implementiert IXmlSerializablewird.
Weitere Informationen
Gilt für:
WriteXml(XmlWriter, XmlWriteMode, Boolean)
Schreibt die aktuellen Daten und optional das Schema für die DataTable Verwendung der angegebenen XmlWriter und XmlWriteMode. Um das Schema zu schreiben, legen Sie den Wert für den mode Parameter auf WriteSchema. Um die Daten für die Tabelle und alle untergeordneten Elemente zu speichern, legen Sie den writeHierarchy Parameter auf true.
public:
void WriteXml(System::Xml::XmlWriter ^ writer, System::Data::XmlWriteMode mode, bool writeHierarchy);
public void WriteXml(System.Xml.XmlWriter writer, System.Data.XmlWriteMode mode, bool writeHierarchy);
member this.WriteXml : System.Xml.XmlWriter * System.Data.XmlWriteMode * bool -> unit
Public Sub WriteXml (writer As XmlWriter, mode As XmlWriteMode, writeHierarchy As Boolean)
Parameter
- mode
- XmlWriteMode
Einer der XmlWriteMode Werte.
- writeHierarchy
- Boolean
Wenn true, schreiben Sie den Inhalt der aktuellen Tabelle und alle untergeordneten Elemente. Wenn false (der Standardwert) die Daten nur für die aktuelle Tabelle schreiben.
Hinweise
Die WriteXml Methode bietet eine Möglichkeit, nur Daten oder sowohl Daten als auch Schema aus einem DataTable XML-Dokument zu schreiben, während die WriteXmlSchema Methode nur das Schema schreibt. Verwenden Sie zum Schreiben von Daten und Schemas eine der Überladungen, die den XmlWriteMode Parameter enthalten, und legen Sie den Wert auf WriteSchema.
Beachten Sie, dass das gleiche für die ReadXml bzw ReadXmlSchema . methoden gilt. Verwenden Sie die ReadXml Methode, um XML-Daten oder sowohl Schema- als auch Daten in die DataTableXml-Datei zu lesen. Verwenden Sie die ReadXmlSchema Methode, um nur das Schema zu lesen.
Normalerweise schreibt die WriteXml Methode die Daten nur für die aktuelle Tabelle. Rufen Sie die Methode auf, um die Daten für die aktuelle Tabelle und deren gesamte absteigende Tabellen zu schreiben, wobei der writeHierarchy Parameter auf . true festgelegt ist.
Note
Es InvalidOperationException wird ein Fehler ausgelöst, wenn ein Spaltentyp im DataRow Lese- oder Schreibvorgang für Implementierungen IDynamicMetaObjectProvider und nicht implementiert IXmlSerializablewird.
Weitere Informationen
Gilt für:
WriteXml(String)
Schreibt den aktuellen Inhalt des DataTable XML-Codes mithilfe der angegebenen Datei.
public:
void WriteXml(System::String ^ fileName);
public void WriteXml(string fileName);
member this.WriteXml : string -> unit
Public Sub WriteXml (fileName As String)
Parameter
- fileName
- String
Die Datei, in die die XML-Daten geschrieben werden sollen.
Hinweise
Die WriteXml Methode bietet eine Möglichkeit, nur Daten oder sowohl Daten als auch Schema aus einem DataTable XML-Dokument zu schreiben, während die WriteXmlSchema Methode nur das Schema schreibt. Verwenden Sie zum Schreiben von Daten und Schemas eine der Überladungen, die den XmlWriteMode Parameter enthalten, und legen Sie den Wert auf WriteSchema.
Beachten Sie, dass das gleiche für die ReadXml bzw ReadXmlSchema . methoden gilt. Verwenden Sie die ReadXml Methode, um XML-Daten oder sowohl Schema- als auch Daten in die DataTableXml-Datei zu lesen. Verwenden Sie die ReadXmlSchema Methode, um nur das Schema zu lesen.
Note
Es InvalidOperationException wird ein Fehler ausgelöst, wenn ein Spaltentyp im DataRow Lese- oder Schreibvorgang für Implementierungen IDynamicMetaObjectProvider und nicht implementiert IXmlSerializablewird.
Weitere Informationen
Gilt für:
WriteXml(TextWriter)
Schreibt den aktuellen Inhalt des DataTable xml-Codes mithilfe des angegebenen TextWriter.
public:
void WriteXml(System::IO::TextWriter ^ writer);
public void WriteXml(System.IO.TextWriter writer);
member this.WriteXml : System.IO.TextWriter -> unit
Public Sub WriteXml (writer As TextWriter)
Parameter
- writer
- TextWriter
Der TextWriter Inhalt, mit dem der Inhalt geschrieben werden soll.
Hinweise
Die WriteXml Methode bietet eine Möglichkeit, nur Daten oder sowohl Daten als auch Schema aus einem DataTable XML-Dokument zu schreiben, während die WriteXmlSchema Methode nur das Schema schreibt. Verwenden Sie zum Schreiben von Daten und Schemas eine der Überladungen, die den XmlWriteMode Parameter enthalten, und legen Sie den Wert auf WriteSchema.
Beachten Sie, dass das gleiche für die ReadXml bzw ReadXmlSchema . methoden gilt. Verwenden Sie die ReadXml Methode, um XML-Daten oder sowohl Schema- als auch Daten in die DataTableXml-Datei zu lesen. Verwenden Sie die ReadXmlSchema Methode, um nur das Schema zu lesen.
Note
Es InvalidOperationException wird ein Fehler ausgelöst, wenn ein Spaltentyp im DataRow Lese- oder Schreibvorgang für Implementierungen IDynamicMetaObjectProvider und nicht implementiert IXmlSerializablewird.
Weitere Informationen
Gilt für:
WriteXml(Stream)
public:
void WriteXml(System::IO::Stream ^ stream);
public void WriteXml(System.IO.Stream stream);
member this.WriteXml : System.IO.Stream -> unit
Public Sub WriteXml (stream As Stream)
Parameter
- stream
- Stream
Der Datenstrom, in den die Daten geschrieben werden.
Hinweise
Die WriteXml Methode bietet eine Möglichkeit, nur Daten oder sowohl Daten als auch Schema aus einem DataTable XML-Dokument zu schreiben, während die WriteXmlSchema Methode nur das Schema schreibt. Verwenden Sie zum Schreiben von Daten und Schemas eine der Überladungen, die den XmlWriteMode Parameter enthalten, und legen Sie den Wert auf WriteSchema.
Beachten Sie, dass das gleiche für die ReadXml bzw ReadXmlSchema . methoden gilt. Verwenden Sie die ReadXml Methode, um XML-Daten oder sowohl Schema- als auch Daten in die DataTableXml-Datei zu lesen. Verwenden Sie die ReadXmlSchema Methode, um nur das Schema zu lesen.
Note
Es InvalidOperationException wird ein Fehler ausgelöst, wenn ein Spaltentyp im DataRow Lese- oder Schreibvorgang für Implementierungen IDynamicMetaObjectProvider und nicht implementiert IXmlSerializablewird.
Weitere Informationen
Gilt für:
WriteXml(String, XmlWriteMode, Boolean)
Schreibt die aktuellen Daten und optional das Schema für die DataTable Verwendung der angegebenen Datei und XmlWriteMode. Um das Schema zu schreiben, legen Sie den Wert für den mode Parameter auf WriteSchema. Um die Daten für die Tabelle und alle untergeordneten Elemente zu speichern, legen Sie den writeHierarchy Parameter auf true.
public:
void WriteXml(System::String ^ fileName, System::Data::XmlWriteMode mode, bool writeHierarchy);
public void WriteXml(string fileName, System.Data.XmlWriteMode mode, bool writeHierarchy);
member this.WriteXml : string * System.Data.XmlWriteMode * bool -> unit
Public Sub WriteXml (fileName As String, mode As XmlWriteMode, writeHierarchy As Boolean)
Parameter
- fileName
- String
Der Name der Datei, in die die Daten geschrieben werden.
- mode
- XmlWriteMode
Einer der XmlWriteMode Werte.
- writeHierarchy
- Boolean
Wenn true, schreiben Sie den Inhalt der aktuellen Tabelle und alle untergeordneten Elemente. Wenn false (der Standardwert) die Daten nur für die aktuelle Tabelle schreiben.
Hinweise
Die WriteXml Methode bietet eine Möglichkeit, nur Daten oder sowohl Daten als auch Schema aus einem DataTable XML-Dokument zu schreiben, während die WriteXmlSchema Methode nur das Schema schreibt. Verwenden Sie zum Schreiben von Daten und Schemas eine der Überladungen, die den XmlWriteMode Parameter enthalten, und legen Sie den Wert auf WriteSchema.
Beachten Sie, dass das gleiche für die ReadXml bzw ReadXmlSchema . methoden gilt. Verwenden Sie die ReadXml Methode, um XML-Daten oder sowohl Schema- als auch Daten in die DataTableXml-Datei zu lesen. Verwenden Sie die ReadXmlSchema Methode, um nur das Schema zu lesen.
Normalerweise speichert die WriteXml Methode Daten nur für die aktuelle Tabelle. Wenn Sie die Daten für die aktuelle Tabelle und das gesamte Schema speichern möchten, bietet die WriteXml Methode eine Möglichkeit, nur Daten oder sowohl Daten als auch Schema aus einem DataTable XML-Dokument zu schreiben, während die WriteXmlSchema Methode nur das Schema schreibt. Verwenden Sie zum Schreiben von Daten und Schemas eine der Überladungen, die den XmlWriteMode Parameter enthalten, und legen Sie den Wert auf WriteSchema.
Beachten Sie, dass das gleiche für die ReadXml bzw ReadXmlSchema . methoden gilt. Verwenden Sie die ReadXml Methode, um XML-Daten oder sowohl Schema- als auch Daten in die DataTableXml-Datei zu lesen. Verwenden Sie die ReadXmlSchema Methode, um nur das Schema zu lesen.
Normalerweise schreibt die WriteXml Methode die Daten nur für die aktuelle Tabelle. Rufen Sie die Methode auf, um die Daten für die aktuelle Tabelle und alle nachfolgerbezogenen Tabellen zu schreiben, auf die der writeHierarchy Parameter festgelegt ist true.
Note
Es InvalidOperationException wird ein Fehler ausgelöst, wenn ein Spaltentyp im DataRow Lese- oder Schreibvorgang für Implementierungen IDynamicMetaObjectProvider und nicht implementiert IXmlSerializablewird.
Weitere Informationen
Gilt für:
WriteXml(XmlWriter)
public:
void WriteXml(System::Xml::XmlWriter ^ writer);
public void WriteXml(System.Xml.XmlWriter writer);
member this.WriteXml : System.Xml.XmlWriter -> unit
Public Sub WriteXml (writer As XmlWriter)
Parameter
Hinweise
Die WriteXml Methode bietet eine Möglichkeit, nur Daten oder sowohl Daten als auch Schema aus einem DataTable XML-Dokument zu schreiben, während die WriteXmlSchema Methode nur das Schema schreibt. Verwenden Sie zum Schreiben von Daten und Schemas eine der Überladungen, die den XmlWriteMode Parameter enthalten, und legen Sie den Wert auf WriteSchema.
Beachten Sie, dass das gleiche für die ReadXml bzw ReadXmlSchema . methoden gilt. Verwenden Sie die ReadXml Methode, um XML-Daten oder sowohl Schema- als auch Daten in die DataTableXml-Datei zu lesen. Verwenden Sie die ReadXmlSchema Methode, um nur das Schema zu lesen.
Note
Es InvalidOperationException wird ein Fehler ausgelöst, wenn ein Spaltentyp im DataRow Lese- oder Schreibvorgang für Implementierungen IDynamicMetaObjectProvider und nicht implementiert IXmlSerializablewird.