Partilhar via


XamlServices.Load Método

Definição

Carrega uma origem em um leitor de XAML e grava a saída como um gráfico de objeto.

Sobrecargas

Load(Stream)

Carrega um Stream de origem em um leitor de XAML e grava a saída como um gráfico de objeto.

Load(TextReader)

Cria um leitor de XAML de um TextReader e retorna um gráfico de objeto.

Load(String)

Carrega um Stream de origem para um leitor de XAML e retorna um gráfico de objeto.

Load(XamlReader)

Carrega uma implementação do leitor de XAML específica e retorna um gráfico de objeto.

Load(XmlReader)

Carrega uma implementação do leitor de XML específica e retorna um gráfico de objeto.

Load(Stream)

Carrega um Stream de origem em um leitor de XAML e grava a saída como um gráfico de objeto.

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

O fluxo a ser carregado como entrada.

Retornos

Object

O gráfico de objeto que é gravado como saída.

Exceções

stream é null.

Comentários

Assinaturas diferentes para o Load(Stream) método especificam diferentes tipos de entrada para o XAML de origem. A Load(Stream) implementação interna primeiro cria uma XmlReader chamada e Create(Stream) , em seguida, cria uma nova instância de um especializado XamlReader que processa a entrada.

Para que a Load(Stream) chamada crie um grafo de objeto com êxito, o seguinte deve ser verdadeiro:

  • A origem é XML bem formada e válida.

  • A origem é XAML válida no nível do idioma.

  • Os tipos XAML especificados no XAML de origem devem ser resolvidos para tipos de suporte nos namespaces XAML relevantes. Por exemplo, os tipos XAML para namespaces do WPF podem ser resolvidos para um namespace XAML do WPF, conforme especificado no XAML; os assemblies do WPF devem ser incluídos no projeto ou disponíveis no tempo de execução; e assim por diante.

Importante

XamlServicesnão é a leitura XAML recomendada ou conjunto de API de gravação XAML se você estiver processando tipos de Windows Presentation Foundation (WPF) ou tipos com base no WPF. Para uso do WPF, use System.Windows.Markup.XamlReader para ler ou carregar XAML; e System.Windows.Markup.XamlWriter para gravar XAML novamente. Essas classes usam System.Xaml APIs internamente em sua implementação; no entanto, elas também dão suporte a conceitos específicos do WPF que influenciam a natureza da leitura e gravação XAML, como otimizações para propriedades de dependência.

Aplica-se a

Load(TextReader)

Cria um leitor de XAML de um TextReader e retorna um gráfico de objeto.

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

O TextReader a ser usado como base para o XmlReader criado.

Retornos

Object

O grafo de objeto que é retornado.

Exceções

textReader é null.

Comentários

Para retornar o grafo de objeto, a textReader entrada deve ser construída usando sua entrada relevante. Por exemplo, ele deve passar um StringReader que é construído usando uma entrada XAML como cadeia de caracteres válida para o StringReader(String) construtor.

Aplica-se a

Load(String)

Carrega um Stream de origem para um leitor de XAML e retorna um gráfico de objeto.

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

O nome do arquivo a ser carregado e usado como origem.

Retornos

Object

O grafo de objeto que é retornado.

Exceções

A entrada fileName é null.

Comentários

Assinaturas diferentes para o Load método especificam diferentes tipos de entrada para o XAML de origem. A Load implementação interna primeiro cria uma XmlReader chamada e Create(String) , em seguida, cria uma nova instância de um especializado XamlReader que processa a entrada.

Para que a Load(String) chamada crie um grafo de objeto com êxito, o seguinte deve ser verdadeiro:

  • A origem é XML bem formada e válida.

  • A origem é XAML válida no nível do idioma.

  • Os tipos XAML especificados no XAML de origem devem ser resolvidos para tipos de suporte nos namespaces XAML relevantes. Por exemplo, os tipos XAML para namespaces do WPF podem ser resolvidos para um namespace XAML do WPF, conforme especificado no XAML; os assemblies do WPF devem ser incluídos no projeto ou estar disponíveis no tempo de execução; e assim por diante.

Aplica-se a

Load(XamlReader)

Carrega uma implementação do leitor de XAML específica e retorna um gráfico de objeto.

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

A implementação do leitor de XAML a ser usado como leitor para esta operação de Load.

Retornos

Object

O grafo de objeto que é retornado.

Exceções

A entrada xamlReader é null.

Comentários

Normalmente, você deve usar essa assinatura somente nos seguintes casos:

  • Você definiu sua própria implementação de um XamlReader.

  • Você especificou configurações para um XamlReader que difere das configurações padrão.

Aplica-se a

Load(XmlReader)

Carrega uma implementação do leitor de XML específica e retorna um gráfico de objeto.

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

A implementação de XmlReader a ser usada como leitor para esta operação de Load.

Retornos

Object

O gráfico de objeto de saída.

Exceções

A entrada xamlReader é null.

Comentários

Normalmente, você deve usar essa assinatura somente se tiver definido sua própria implementação de um XmlReader.

Aplica-se a