XamlServices.Load Método

Definición

Espacio de nombres:: System.Xaml

Ensamblado:: System.Xaml.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Carga el origen de un lector XAML y escribe su salida como gráfico de objetos.

Sobrecargas

Nombre	Description
Load(Stream)	Carga un Stream origen para un lector XAML y escribe su salida como gráfico de objetos.
Load(TextReader)	Crea un lector XAML a partir de y TextReaderdevuelve un gráfico de objetos.
Load(String)	Carga un Stream origen para un lector XAML y devuelve un gráfico de objetos.
Load(XamlReader)	Carga una implementación específica del lector XAML y devuelve un gráfico de objetos.
Load(XmlReader)	Carga una implementación específica del lector XML y devuelve un gráfico de objetos.

Load(Stream)

Carga un Stream origen para un lector XAML y escribe su salida como gráfico de objetos.

public:
 static System::Object ^ Load(System::IO::Stream ^ stream);

public static object Load(System.IO.Stream stream);

static member Load : System.IO.Stream -> obj

Public Shared Function Load (stream As Stream) As Object

Parámetros

stream: Stream

Flujo que se va a cargar como entrada.

Devoluciones

Object

Gráfico de objetos que se escribe como salida.

Excepciones

ArgumentNullException

stream es null.

Comentarios

Diferentes firmas para el Load(Stream) método especifican diferentes tipos de entrada para el CÓDIGO XAML de origen. La Load(Stream) implementación interna crea primero un mediante una XmlReader llamada Create(Stream) a y, a continuación, crea una nueva instancia de un especializado XamlReader que procesa la entrada.

Para que la Load(Stream) llamada cree correctamente un gráfico de objetos, debe cumplirse lo siguiente:

El origen tiene un formato correcto y xml válido.
El origen es XAML válido en el nivel de lenguaje.
Los tipos XAML especificados en el XAML de origen deben resolverse para respaldar tipos en los espacios de nombres XAML pertinentes. Por ejemplo, los tipos XAML para WPF espacios de nombres pueden resolverse en un espacio de nombres XAML WPF tal como se especifica en XAML; los ensamblados de WPF deben incluirse en el proyecto o estar disponibles en tiempo de ejecución, etc.

Importante

XamlServices no es el conjunto de API de lectura xaml o escritura XAML recomendado si está procesando tipos de Windows Presentation Foundation (WPF) o tipos basados en WPF. Para el uso de WPF, use System.Windows.Markup.XamlReader para leer o cargar XAML; y System.Windows.Markup.XamlWriter para escribir XAML. Estas clases usan System.Xaml las API internamente en su implementación; sin embargo, también proporcionan compatibilidad con conceptos específicos de WPF que influyen en la naturaleza de la lectura y escritura de XAML, como las optimizaciones para las propiedades de dependencia.

Se aplica a

Load(TextReader)

Crea un lector XAML a partir de y TextReaderdevuelve un gráfico de objetos.

public:
 static System::Object ^ Load(System::IO::TextReader ^ textReader);

public static object Load(System.IO.TextReader textReader);

static member Load : System.IO.TextReader -> obj

Public Shared Function Load (textReader As TextReader) As Object

Parámetros

textReader: TextReader

que TextReader se va a usar como base para el objeto creado XmlReader.

Devoluciones

Object

Gráfico de objetos que se devuelve.

Excepciones

ArgumentNullException

textReader es null.

Comentarios

Para devolver el gráfico de objetos, la textReader entrada se debe construir mediante su entrada pertinente. Por ejemplo, debe pasar un StringReader que se construye mediante una entrada XAML como cadena válida para el StringReader(String) constructor.

Se aplica a

Load(String)

Carga un Stream origen para un lector XAML y devuelve un gráfico de objetos.

public:
 static System::Object ^ Load(System::String ^ fileName);

public static object Load(string fileName);

static member Load : string -> obj

Public Shared Function Load (fileName As String) As Object

Parámetros

fileName: String

Nombre de archivo que se va a cargar y usar como origen.

Devoluciones

Object

Gráfico de objetos que se devuelve.

Excepciones

ArgumentNullException

fileName input es null.

Comentarios

Diferentes firmas para el Load método especifican diferentes tipos de entrada para el CÓDIGO XAML de origen. La Load implementación interna crea primero un mediante una XmlReader llamada Create(String) a y, a continuación, crea una nueva instancia de un especializado XamlReader que procesa la entrada.

Para que la Load(String) llamada cree correctamente un gráfico de objetos, debe cumplirse lo siguiente:

El origen tiene un formato correcto y xml válido.
El origen es XAML válido en el nivel de lenguaje.
Los tipos XAML especificados en el XAML de origen deben resolverse para respaldar tipos en los espacios de nombres XAML pertinentes. Por ejemplo, los tipos XAML de WPF espacios de nombres pueden resolverse en un espacio de nombres XAML de WPF tal como se especifica en xaml; los ensamblados de WPF deben incluirse en el proyecto o estar disponibles en tiempo de ejecución, etc.

Se aplica a

Load(XamlReader)

Carga una implementación específica del lector XAML y devuelve un gráfico de objetos.

public:
 static System::Object ^ Load(System::Xaml::XamlReader ^ xamlReader);

public static object Load(System.Xaml.XamlReader xamlReader);

static member Load : System.Xaml.XamlReader -> obj

Public Shared Function Load (xamlReader As XamlReader) As Object

Parámetros

xamlReader: XamlReader

Implementación del lector XAML que se usará como lector para esta Load operación.

Devoluciones

Object

Gráfico de objetos que se devuelve.

Excepciones

ArgumentNullException

xamlReader input es null.

Comentarios

Normalmente, solo debe usar esta firma en los casos siguientes:

Ha definido su propia implementación de .XamlReader
Especificó la configuración de un XamlReader que difiere de la configuración predeterminada.

Se aplica a

Load(XmlReader)

Carga una implementación específica del lector XML y devuelve un gráfico de objetos.

public:
 static System::Object ^ Load(System::Xml::XmlReader ^ xmlReader);

public static object Load(System.Xml.XmlReader xmlReader);

static member Load : System.Xml.XmlReader -> obj

Public Shared Function Load (xmlReader As XmlReader) As Object

Parámetros

xmlReader: XmlReader

Implementación XmlReader que se va a usar como lector para esta Load operación.

Devoluciones

Object

Gráfico de objetos de salida.

Excepciones

ArgumentNullException

xmlReader input es null.

Comentarios

Normalmente, solo debe usar esta firma si definió su propia implementación de .XmlReader

Se aplica a

Comentaris

Us ha resultat útil aquesta pàgina?