XmlWriter.WriteValue Metod

Definition

Namnområde:: System.Xml

Sammansättningar:: System.Xml.dll, System.Xml.ReaderWriter.dll

Sammansättningar:: netstandard.dll, System.Xml.ReaderWriter.dll

Sammansättning:: System.Xml.ReaderWriter.dll

Sammansättning:: System.Xml.dll

Sammansättning:: netstandard.dll

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.

Skriver ett enda enkelt typat värde.

Överlagringar

Name	Description
WriteValue(Single)	Skriver ett flyttal med enkel precision.
WriteValue(Object)	Skriver objektvärdet.
WriteValue(Int64)	Skriver ett Int64 värde.
WriteValue(Int32)	Skriver ett Int32 värde.
WriteValue(Double)	Skriver ett Double värde.
WriteValue(String)	Skriver ett String värde.
WriteValue(DateTimeOffset)	Skriver ett DateTimeOffset värde.
WriteValue(DateTime)	Skriver ett DateTime värde.
WriteValue(Boolean)	Skriver ett Boolean värde.
WriteValue(Decimal)	Skriver ett Decimal värde.

Kommentarer

Metoden WriteValue accepterar vanliga språkkörningsvärden (CLR), konverterar dem till sina strängrepresentationer enligt reglerna för konvertering av XML-schemadefinitionsspråk (XSD) och skriver ut dem med hjälp WriteString av metoden. På så sätt kan du pipeline-värden av enkel typ med minimala omkostnader vid överföring av data mellan XPathDocument, XmlReaderoch XmlWriter -objekt. Den här möjligheten är också användbar när du hanterar enkla CLR-typer och en XmlWriter instans. Du kan anropa WriteValue metoden för att skriva det inskrivna värdet i stället för att använda metoderna i XmlConvert klassen för att konvertera de inskrivna data till ett strängvärde innan du skriver ut det.

För asynkrona åtgärder konverterar du returvärdet WriteValue för till en sträng och använder WriteStringAsync metoden.

I följande tabell visas standarddatatyperna för XSD som motsvarar CLR-typer.

Om CLR-objektet är en listtyp, till exempel IEnumerable, IListeller ICollection, behandlas det som en matris av värdetypen.

CLR-typ	Standarddatatyp för XSD
System.Boolean	xsd:booleskt värde
System.Byte**	xsd:heltal
System.Byte samling	xsd:base64Binary
System.Char**	xsd:string
System.DateTime	xsd:dateTime
System.Decimal	xsd:decimal
System.Double	xsd:double
System.Int16**	xsd:heltal
System.Int32	xsd:heltal
System.Int64	xsd:heltal
System.Single	xsd:float
System.String	xsd:string
System.IO.TextReader	xsd:string
System.IO.BinaryReader	xsd:base64Binary

**Dessa typer är inte CLS-kompatibla. De har inte motsvarande WriteValue metoder.

Om WriteValue anropas flera gånger i följd avgränsas inte värdena av ett blanksteg. Du måste anropa WriteWhitespace mellan anrop till för att WriteValue infoga tomt utrymme.

WriteValue(Single)

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Skriver ett flyttal med enkel precision.

public:
 virtual void WriteValue(float value);

public virtual void WriteValue(float value);

abstract member WriteValue : single -> unit
override this.WriteValue : single -> unit

Public Overridable Sub WriteValue (value As Single)

Parametrar

value: Single

Flyttal med enkel precision som ska skrivas.

Undantag

ArgumentException

Ett ogiltigt värde har angetts.

InvalidOperationException

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

Den här metoden använder det vanliga språkkörningsobjektet och konverterar indatavärdet till önskad utdatatyp med hjälp av konverteringsreglerna för XML-schemadefinitionsspråk (XSD).

WriteValue När metoden anropas XmlWriter konverteras värdet till dess strängrepresentationer enligt reglerna för XML-schemadatatyp (XSD) och skriver ut det med hjälp av WriteString metoden.

Om WriteValue anropas flera gånger i följd avgränsas inte värdena av ett blanksteg. Du måste anropa WriteWhitespace mellan anrop till för att WriteValue infoga tomt utrymme. Skicka en matristyp till överlagringen XmlWriter.WriteValue(Object) för att skriva ut en matris med distinkta värden.

Om den här metoden anropas på en XmlWriter instans som endast matar ut text serialiseras det inskrivna värdet till text.

För asynkrona åtgärder konverterar du returvärdet för den här metoden till en sträng och använder WriteStringAsync metoden.

Gäller för

WriteValue(Object)

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Skriver objektvärdet.

public:
 virtual void WriteValue(System::Object ^ value);

public virtual void WriteValue(object value);

abstract member WriteValue : obj -> unit
override this.WriteValue : obj -> unit

Public Overridable Sub WriteValue (value As Object)

Parametrar

value: Object

Objektvärdet som ska skrivas.

Note Med lanseringen av .NET Framework 3.5 accepterar den här metoden DateTimeOffset som en parameter.

Undantag

ArgumentException

Ett ogiltigt värde har angetts.

ArgumentNullException

value är null.

InvalidOperationException

Skrivaren är stängd eller i feltillstånd.

-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

Den här metoden använder CLR-objektet (Common Language Runtime) och konverterar indatavärdet till önskad utdatatyp med hjälp av konverteringsreglerna för datatypen XSD (XML Schema Definition Language).

Om CLR-objektet är en listtyp som IEnumerable, IListeller ICollection, behandlas det som en matris av värdetypen. Konverterar XmlWriter värdet till dess strängrepresentationer enligt reglerna för XML-schemadatatyp (XSD) och skriver ut det med hjälp av WriteString metoden.

Om den här metoden anropas på en XmlWriter instans som endast matar ut text serialiseras det inskrivna värdet till text.

För asynkrona åtgärder konverterar du returvärdet för den här metoden till en sträng och använder WriteStringAsync metoden.

Gäller för

WriteValue(Int64)

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Skriver ett Int64 värde.

public:
 virtual void WriteValue(long value);

public virtual void WriteValue(long value);

abstract member WriteValue : int64 -> unit
override this.WriteValue : int64 -> unit

Public Overridable Sub WriteValue (value As Long)

Parametrar

value: Int64

Värdet Int64 som ska skrivas.

Undantag

ArgumentException

Ett ogiltigt värde har angetts.

InvalidOperationException

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

Den här metoden använder det vanliga språkkörningsobjektet och konverterar indatavärdet till önskad utdatatyp med hjälp av konverteringsreglerna för XML-schemadefinitionsspråk (XSD).

WriteValue När metoden anropas XmlWriter konverteras värdet till dess strängrepresentationer enligt reglerna för XML-schemadatatyp (XSD) och skriver ut det med hjälp av WriteString metoden.

Om den här metoden anropas på en XmlWriter instans som endast matar ut text serialiseras det inskrivna värdet till text.

För asynkrona åtgärder konverterar du returvärdet för den här metoden till en sträng och använder WriteStringAsync metoden.

Gäller för

WriteValue(Int32)

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Skriver ett Int32 värde.

public:
 virtual void WriteValue(int value);

public virtual void WriteValue(int value);

abstract member WriteValue : int -> unit
override this.WriteValue : int -> unit

Public Overridable Sub WriteValue (value As Integer)

Parametrar

value: Int32

Värdet Int32 som ska skrivas.

Undantag

ArgumentException

Ett ogiltigt värde har angetts.

InvalidOperationException

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

Den här metoden använder det vanliga språkkörningsobjektet och konverterar indatavärdet till önskad utdatatyp med hjälp av konverteringsreglerna för XML-schemadefinitionsspråk (XSD).

WriteValue När metoden anropas XmlWriter konverteras värdet till dess strängrepresentationer enligt reglerna för XML-schemadatatyp (XSD) och skriver ut det med hjälp av WriteString metoden.

Om den här metoden anropas på en XmlWriter instans som endast matar ut text serialiseras det inskrivna värdet till text.

För asynkrona åtgärder konverterar du returvärdet för den här metoden till en sträng och använder WriteStringAsync metoden.

Gäller för

WriteValue(Double)

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Skriver ett Double värde.

public:
 virtual void WriteValue(double value);

public virtual void WriteValue(double value);

abstract member WriteValue : double -> unit
override this.WriteValue : double -> unit

Public Overridable Sub WriteValue (value As Double)

Parametrar

value: Double

Värdet Double som ska skrivas.

Undantag

ArgumentException

Ett ogiltigt värde har angetts.

InvalidOperationException

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".

Exempel

I följande exempel skrivs en boknod med hjälp av inskrivna data.

Double price = 9.95;
DateTime date = new DateTime(2004, 5, 20);

using (XmlWriter writer = XmlWriter.Create("data.xml"))
{
    writer.WriteStartElement("book");
    writer.WriteStartAttribute("pub-date");
    writer.WriteValue(date);
    writer.WriteEndAttribute();

    writer.WriteStartElement("price");
    writer.WriteValue(price);
    writer.WriteEndElement();

    writer.WriteEndElement();
    writer.Flush();
}

Dim price As [Double] = 9.95
Dim [date] As New DateTime(2004, 5, 20)
        
Using writer As XmlWriter = XmlWriter.Create("data.xml")
  writer.WriteStartElement("book")
  writer.WriteStartAttribute("pub-date")
  writer.WriteValue([date])
  writer.WriteEndAttribute()
            
  writer.WriteStartElement("price")
  writer.WriteValue(price)
  writer.WriteEndElement()
            
  writer.WriteEndElement()
  writer.Flush()
End Using

Kommentarer

Den här metoden använder det vanliga språkkörningsobjektet och konverterar indatavärdet till önskad utdatatyp med hjälp av konverteringsreglerna för XML-schemadefinitionsspråk (XSD).

WriteValue När metoden anropas XmlWriter konverteras värdet till dess strängrepresentationer enligt reglerna för XML-schemadatatyp (XSD) och skriver ut det med hjälp av WriteString metoden.

Om den här metoden anropas på en XmlWriter instans som endast matar ut text serialiseras det inskrivna värdet till text.

För asynkrona åtgärder konverterar du returvärdet för den här metoden till en sträng och använder WriteStringAsync metoden.

Gäller för

WriteValue(String)

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Skriver ett String värde.

public:
 virtual void WriteValue(System::String ^ value);

public virtual void WriteValue(string value);

public virtual void WriteValue(string? value);

abstract member WriteValue : string -> unit
override this.WriteValue : string -> unit

Public Overridable Sub WriteValue (value As String)

Parametrar

value: String

Värdet String som ska skrivas.

Undantag

ArgumentException

Ett ogiltigt värde har angetts.

InvalidOperationException

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

Den här metoden använder det vanliga språkkörningsobjektet och konverterar indatavärdet till önskad utdatatyp med hjälp av konverteringsreglerna för XML-schemadefinitionsspråk (XSD).

Om den här metoden anropas på en XmlWriter instans som endast matar ut text serialiseras det inskrivna värdet till text.

Använd metoden för WriteStringAsync asynkrona åtgärder.

Gäller för

WriteValue(DateTimeOffset)

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Skriver ett DateTimeOffset värde.

public:
 virtual void WriteValue(DateTimeOffset value);

public virtual void WriteValue(DateTimeOffset value);

abstract member WriteValue : DateTimeOffset -> unit
override this.WriteValue : DateTimeOffset -> unit

Public Overridable Sub WriteValue (value As DateTimeOffset)

Parametrar

value: DateTimeOffset

Värdet DateTimeOffset som ska skrivas.

Undantag

InvalidOperationException

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

För asynkrona åtgärder konverterar du returvärdet för den här metoden till en sträng och använder WriteStringAsync metoden.

Gäller för

WriteValue(DateTime)

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Skriver ett DateTime värde.

public:
 virtual void WriteValue(DateTime value);

public virtual void WriteValue(DateTime value);

abstract member WriteValue : DateTime -> unit
override this.WriteValue : DateTime -> unit

Public Overridable Sub WriteValue (value As DateTime)

Parametrar

value: DateTime

Värdet DateTime som ska skrivas.

Undantag

ArgumentException

Ett ogiltigt värde har angetts.

InvalidOperationException

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".

Exempel

I följande exempel skrivs en boknod med hjälp av inskrivna data.

Double price = 9.95;
DateTime date = new DateTime(2004, 5, 20);

using (XmlWriter writer = XmlWriter.Create("data.xml"))
{
    writer.WriteStartElement("book");
    writer.WriteStartAttribute("pub-date");
    writer.WriteValue(date);
    writer.WriteEndAttribute();

    writer.WriteStartElement("price");
    writer.WriteValue(price);
    writer.WriteEndElement();

    writer.WriteEndElement();
    writer.Flush();
}

Dim price As [Double] = 9.95
Dim [date] As New DateTime(2004, 5, 20)
        
Using writer As XmlWriter = XmlWriter.Create("data.xml")
  writer.WriteStartElement("book")
  writer.WriteStartAttribute("pub-date")
  writer.WriteValue([date])
  writer.WriteEndAttribute()
            
  writer.WriteStartElement("price")
  writer.WriteValue(price)
  writer.WriteEndElement()
            
  writer.WriteEndElement()
  writer.Flush()
End Using

Kommentarer

Den här metoden använder det vanliga språkkörningsobjektet och konverterar indatavärdet till önskad utdatatyp med hjälp av konverteringsreglerna för XML-schemadefinitionsspråk (XSD).

WriteValue När metoden anropas XmlWriter konverteras värdet till dess strängrepresentationer enligt reglerna för XML-schemadatatyp (XSD) och skriver ut det med hjälp av WriteString metoden.

Om den här metoden anropas på en XmlWriter instans som endast matar ut text serialiseras det inskrivna värdet till text.

För asynkrona åtgärder konverterar du returvärdet för den här metoden till en sträng och använder WriteStringAsync metoden.

Gäller för

WriteValue(Boolean)

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Skriver ett Boolean värde.

public:
 virtual void WriteValue(bool value);

public virtual void WriteValue(bool value);

abstract member WriteValue : bool -> unit
override this.WriteValue : bool -> unit

Public Overridable Sub WriteValue (value As Boolean)

Parametrar

value: Boolean

Värdet Boolean som ska skrivas.

Undantag

ArgumentException

Ett ogiltigt värde har angetts.

InvalidOperationException

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

Den här metoden använder det vanliga språkkörningsobjektet och konverterar indatavärdet till önskad utdatatyp med hjälp av konverteringsreglerna för XML-schemadefinitionsspråk (XSD).

WriteValue När metoden anropas XmlWriter konverteras värdet till dess strängrepresentationer enligt reglerna för XML-schemadatatyp (XSD) och skriver ut det med hjälp av WriteString metoden.

Om den här metoden anropas på en XmlWriter instans som endast matar ut text serialiseras det inskrivna värdet till text.

För asynkrona åtgärder konverterar du returvärdet för den här metoden till en sträng och använder WriteStringAsync metoden.

Gäller för

WriteValue(Decimal)

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Skriver ett Decimal värde.

public:
 virtual void WriteValue(System::Decimal value);

public virtual void WriteValue(decimal value);

abstract member WriteValue : decimal -> unit
override this.WriteValue : decimal -> unit

Public Overridable Sub WriteValue (value As Decimal)

Parametrar

value: Decimal

Värdet Decimal som ska skrivas.

Undantag

ArgumentException

Ett ogiltigt värde har angetts.

InvalidOperationException

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

Den här metoden använder det vanliga språkkörningsobjektet och konverterar indatavärdet till önskad utdatatyp med hjälp av konverteringsreglerna för XML-schemadefinitionsspråk (XSD).

WriteValue När metoden anropas XmlWriter konverteras värdet till dess strängrepresentationer enligt reglerna för XML-schemadatatyp (XSD) och skriver ut det med hjälp av WriteString metoden.

Om den här metoden anropas på en XmlWriter instans som endast matar ut text serialiseras det inskrivna värdet till text.

För asynkrona åtgärder konverterar du returvärdet för den här metoden till en sträng och använder WriteStringAsync metoden.

Gäller för

Feedback

Var den här sidan till hjälp?