XmlWriter.WriteStartDocument Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
När du åsidosättas i en härledd klass skriver du XML-deklarationen.
Överlagringar
| Name | Description |
|---|---|
| WriteStartDocument(Boolean) |
När den åsidosättas i en härledd klass skriver du XML-deklarationen med versionen "1.0" och det fristående attributet. |
| WriteStartDocument() |
När den åsidosättas i en härledd klass skriver du XML-deklarationen med versionen "1.0". |
Kommentarer
Den asynkrona versionen av den här metoden finns i WriteStartDocumentAsync.
WriteStartDocument(Boolean)
- Källa:
- XmlWriter.cs
- Källa:
- XmlWriter.cs
- Källa:
- XmlWriter.cs
- Källa:
- XmlWriter.cs
- Källa:
- XmlWriter.cs
När den åsidosättas i en härledd klass skriver du XML-deklarationen med versionen "1.0" och det fristående attributet.
public:
abstract void WriteStartDocument(bool standalone);public abstract void WriteStartDocument(bool standalone);abstract member WriteStartDocument : bool -> unitPublic MustOverride Sub WriteStartDocument (standalone As Boolean)Parametrar
- standalone
- Boolean
Om trueskriver den "standalone=yes"; om false, skriver den "standalone=no".
Undantag
Det här är inte den första skrivmetoden som anropas efter konstruktorn.
-eller-
En XmlWriter metod anropades innan en tidigare asynkron åtgärd slutfördes. I det här fallet InvalidOperationException genereras meddelandet "En asynkron åtgärd pågår redan".
Kommentarer
Kodningsnivån för dokumentet bestäms av hur skrivaren implementeras. Om ett Encoding objekt till exempel anges i XmlTextWriter konstruktorn avgör detta värdet för kodningsattributet.
När WriteStartDocument det anropas verifierar författaren att det du skriver är ett välformat XML-dokument. Den kontrollerar till exempel att XML-deklarationen är den första noden, att ett och endast ett element på rotnivå finns och så vidare. Om den här metoden inte anropas förutsätter skrivaren att ett XML-fragment skrivs och inte tillämpar några regler på rotnivå.
Om WriteStartDocument har anropats och sedan WriteProcessingInstruction metoden används för att skapa en annan XML-deklaration genereras ett undantag.
Den asynkrona versionen av den här metoden finns i WriteStartDocumentAsync.
Gäller för
WriteStartDocument()
- Källa:
- XmlWriter.cs
- Källa:
- XmlWriter.cs
- Källa:
- XmlWriter.cs
- Källa:
- XmlWriter.cs
- Källa:
- XmlWriter.cs
När den åsidosättas i en härledd klass skriver du XML-deklarationen med versionen "1.0".
public:
abstract void WriteStartDocument();public abstract void WriteStartDocument();abstract member WriteStartDocument : unit -> unitPublic MustOverride Sub WriteStartDocument ()Undantag
Det här är inte den första skrivmetoden som anropas efter konstruktorn.
-eller-
En XmlWriter metod anropades innan en tidigare asynkron åtgärd slutfördes. I det här fallet InvalidOperationException genereras meddelandet "En asynkron åtgärd pågår redan".
Kommentarer
Kodningsnivån för dokumentet bestäms av hur skrivaren implementeras. Om ett Encoding objekt till exempel anges i XmlTextWriter konstruktorn avgör detta värdet för kodningsattributet. Den här metoden skapar inte ett fristående attribut.
När WriteStartDocument kallas skrivaren verifierar att det du skriver är ett välformat XML-dokument. Den kontrollerar till exempel att XML-deklarationen är den första noden, att ett och endast ett element på rotnivå finns och så vidare. Om den här metoden inte anropas förutsätter skrivaren att ett XML-fragment skrivs och inte tillämpar några regler på rotnivå.
Om WriteStartDocument har anropats och sedan WriteProcessingInstruction metoden används för att skapa en annan XML-deklaration genereras ett undantag.
Den asynkrona versionen av den här metoden finns i WriteStartDocumentAsync.
