XmlSerializationWriter.WriteNullableStringEncoded Method

Definition

Namespace:

System.Xml.Serialization

Assembly:

System.Xml.XmlSerializer.dll

Source:

XmlSerializationWriter.cs

Writes an XML element that contains a string as the body. XmlWriter inserts an xsi:nil='true' attribute if the string's value is null.

This API supports the product infrastructure and is not intended to be used directly from your code.

protected:
 void WriteNullableStringEncoded(System::String ^ name, System::String ^ ns, System::String ^ value, System::Xml::XmlQualifiedName ^ xsiType);

protected void WriteNullableStringEncoded (string name, string? ns, string? value, System.Xml.XmlQualifiedName? xsiType);

member this.WriteNullableStringEncoded : string * string * string * System.Xml.XmlQualifiedName -> unit

Protected Sub WriteNullableStringEncoded (name As String, ns As String, value As String, xsiType As XmlQualifiedName)

Parameters

name

String

The local name of the XML element to write.

ns

String

The namespace of the XML element to write.

value

String

The string to write in the body of the XML element.

xsiType

XmlQualifiedName

The name of the XML Schema data type to be written to the xsi:type attribute.

Remarks

The protected members of XmlSerializationWriter are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure.

When set to true, the nil attribute from the XML Schema instance namespace (abbreviated xsi) indicates a null value.

The WriteNullableStringEncoded method is called only when writing SOAP-encoded XML, as described in Section 5 of the SOAP 1.1 specification.