XdmWriter.Create Method (string, XmlNameTable, XdmWriterSettings)XdmWriter.Create Method (String, XmlNameTable, XdmWriterSettings)XdmWriter::Create Method (String^, XmlNameTable^, XdmWriterSettings^)

Creates an XdmWriterXdmWriterXdmWriter instance using the specified stream, XML name table and XdmWriterSettingsXdmWriterSettingsXdmWriterSettings object.

Syntax

Public Shared Function Create( _
    outputFileName As String, _
    nameTable As System.Xml.XmlNameTable, _
    settings As XdmWriterSettings _
) As XdmWriter
public static XdmWriter Create(
    string outputFileName,
    System.Xml.XmlNameTable nameTable,
    XdmWriterSettings settings
)
public:
static XdmWriter^ Create(
    String^ outputFileName, 
    System.Xml::XmlNameTable^ nameTable, 
    XdmWriterSettings^ settings
)
 

Parameters

outputFileName

Type: System.StringSystem.StringSystem::String^

The name of the file to which you want to write. The outputFileName must be a file system path.

nameTable

Type: System.Xml.XmlNameTableSystem.Xml.XmlNameTableSystem.Xml::XmlNameTable^

An XmlNameTableXmlNameTableXmlNameTable object.

settings

Type: XmlPrime.Serialization.XdmWriterSettingsXmlPrime.Serialization.XdmWriterSettingsXmlPrime.Serialization::XdmWriterSettings^

The XdmWriterSettingsXdmWriterSettingsXdmWriterSettings object used to configure the new XdmWriterXdmWriterXdmWriter instance. If this is null a null reference (Nothing in Visual Basic) nullptr, an XdmWriterSettingsXdmWriterSettingsXdmWriterSettings with default settings is used.

If the XdmWriterXdmWriterXdmWriter is being used with the Serialize (XmlWriter)Serialize (XmlWriter)Serialize (XmlWriter^) method, you should use the SerializationSettingsSerializationSettingsSerializationSettings property to obtain an XdmWriterXdmWriterXdmWriter object with the correct settings.

Exceptions

ExceptionCondition
ArgumentNullExceptionArgumentNullExceptionArgumentNullException outputFileName is null a null reference (Nothing in Visual Basic) nullptr.
XdmExceptionXdmExceptionXdmExceptionThere is an error with the serialization configuration.