XamlServices.Load Método

  • Referencia

Definición

Espacio de nombres:
System.Xaml
Ensamblado:
System.Xaml.dll

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

Sobrecargas

Load(Stream)

Carga un origen Stream para un lector XAML y escribe la salida como un gráfico de objetos.
Load(TextReader)

Crea un lector XAML a partir de un objeto TextReader y devuelve un gráfico de objetos.
Load(String)

Carga un Stream de origen para un lector XAML y devuelve un gráfico de objetos.
Load(XamlReader)

Carga una implementación de lector XAML concreta y devuelve un gráfico de objetos.
Load(XmlReader)

Carga una implementación de lector XML concreta y devuelve un gráfico de objetos.

Load(Stream)

Carga un origen Stream para un lector XAML y escribe la salida como un 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

Secuencia que se va a cargar como entrada.

Devoluciones

Object

Gráfico de objetos que se escribe como salida.

Excepciones

ArgumentNullException

stream es null.

Comentarios

Las distintas firmas para el Load(Stream) método especifican diferentes tipos de entrada para el XAML de origen. La Load(Stream) implementación interna crea primero un XmlReader mediante una 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 en tipos de respaldo en los espacios de nombres XAML pertinentes. Por ejemplo, los tipos XAML para espacios de nombres WPF pueden resolverse en un espacio de nombres XAML de WPF, tal como se especifica en el XAML; los ensamblados para WPF deben incluirse en el proyecto o estar disponibles en tiempo de ejecución; y así sucesivamente.

Importante

XamlServicesno es el conjunto de API de lectura XAML o escritura XAML recomendado si está procesando tipos 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 un objeto TextReader y devuelve 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

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

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 debe construirse 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 de 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 del archivo que se va a cargar y usar como origen.

Devoluciones

Object

Gráfico de objetos que se devuelve.

Excepciones

ArgumentNullException

La entrada de fileName es null.

Comentarios

Las distintas firmas para el Load método especifican diferentes tipos de entrada para el XAML de origen. La Load implementación interna crea primero un XmlReader mediante una 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 en tipos de respaldo en los espacios de nombres XAML pertinentes. Por ejemplo, los tipos XAML para espacios de nombres WPF pueden resolverse en un espacio de nombres XAML de WPF, tal como se especifica en el XAML; los ensamblados para WPF deben incluirse en el proyecto o estar disponibles en tiempo de ejecución; y así sucesivamente.

Se aplica a

Load(XamlReader)

Carga una implementación de lector XAML concreta 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 de lector XAML que se va a utilizar como lector para esta operación Load.

Devoluciones

Object

Gráfico de objetos que se devuelve.

Excepciones

ArgumentNullException

La entrada de xamlReader 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 para un XamlReader objeto que difiere de la configuración predeterminada.

Se aplica a

Load(XmlReader)

Carga una implementación de lector XML concreta 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 de XmlReader que se va a utilizar como lector para esta operación Load.

Devoluciones

Object

Gráfico de objetos de salida.

Excepciones

ArgumentNullException

La entrada de xamlReader es null.

Comentarios

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

Se aplica a