XmlSerializationWriter.WriteNullableStringEncoded Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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);
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.