XamlServices.Load Método

Definição

Espaço de Nomes:: System.Xaml

Assemblagem:: System.Xaml.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Carrega a fonte para um leitor XAML e escreve a sua saída como um grafo de objetos.

Sobrecargas

Name	Description
Load(Stream)	Carrega uma Stream fonte para um leitor XAML e escreve a sua saída como um grafo de objetos.
Load(TextReader)	Cria um leitor XAML a partir de um TextReader, e devolve um grafo objeto.
Load(String)	Carrega uma Stream fonte para um leitor XAML e retorna um grafo de objetos.
Load(XamlReader)	Carrega uma implementação específica de leitor XAML e retorna um grafo de objetos.
Load(XmlReader)	Carrega uma implementação específica de leitor XML e devolve um grafo de objetos.

Load(Stream)

Carrega uma Stream fonte para um leitor XAML e escreve a sua saída como um grafo 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

O fluxo para carregar como entrada.

Devoluções

Object

O grafo de objeto que é escrito como saída.

Exceções

ArgumentNullException

stream é null.

Observações

Diferentes assinaturas para o Load(Stream) método especificam diferentes tipos de entrada para o XAML de origem. A Load(Stream) implementação interna cria primeiro uma XmlReader chamada Create(Stream) by e depois cria uma nova instância de um specialized XamlReader que processa a entrada.

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

A fonte é um XML bem formado e válido.
A fonte é válida em XAML ao nível da linguagem.
Os tipos XAML especificados no XAML de origem devem ser resolvidos para tipos de apoio nos namespaces XAML relevantes. Por exemplo, os tipos XAML para namespaces WPF podem ser resolvidos para um namespace WPF XAML conforme especificado no XAML; os assemblies para WPF devem estar incluídos no projeto ou disponíveis em tempo de execução; e assim sucessivamente.

Importante

XamlServices não é o conjunto recomendado de leitura XAML ou de API de escrita XAML se estiver a processar Windows Presentation Foundation tipos (WPF), ou tipos baseados em WPF. Para uso WPF, use System.Windows.Markup.XamlReader para ler ou carregar XAML; e System.Windows.Markup.XamlWriter para reescrever XAML. Estas classes utilizam APIs System.Xaml internamente na sua implementação; no entanto, também fornecem suporte para conceitos específicos do WPF que influenciam a natureza da leitura e escrita de XAML, como otimizações para propriedades de dependência.

Aplica-se a

Load(TextReader)

Cria um leitor XAML a partir de um TextReader, e devolve um grafo 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 para usar como base para o criado XmlReader.

Devoluções

Object

O grafo objeto que é devolvido.

Exceções

ArgumentNullException

textReader é null.

Observações

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

Aplica-se a

Load(String)

Carrega uma Stream fonte para um leitor XAML e retorna um grafo 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

O nome do ficheiro a carregar e usar como fonte.

Devoluções

Object

O grafo objeto que é devolvido.

Exceções

ArgumentNullException

fileName a entrada é null.

Observações

Diferentes assinaturas para o Load método especificam diferentes tipos de entrada para o XAML de origem. A Load implementação interna cria primeiro uma XmlReader chamada Create(String) by e depois cria uma nova instância de um specialized XamlReader que processa a entrada.

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

A fonte é um XML bem formado e válido.
A fonte é válida em XAML ao nível da linguagem.
Os tipos XAML especificados no XAML de origem devem ser resolvidos para tipos de apoio nos namespaces XAML relevantes. Por exemplo, tipos XAML para namespaces WPF podem resolver para um namespace WPF XAML conforme especificado no XAML; os assemblies para WPF devem estar incluídos no projeto ou estar disponíveis em tempo de execução; e assim sucessivamente.

Aplica-se a

Load(XamlReader)

Carrega uma implementação específica de leitor XAML e retorna um grafo 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

A implementação do leitor XAML para usar como leitor para esta Load operação.

Devoluções

Object

O grafo objeto que é devolvido.

Exceções

ArgumentNullException

xamlReader a entrada é null.

Observações

Normalmente, deve usar esta assinatura apenas nos seguintes casos:

Definiste a tua própria implementação de um XamlReader.
Especificaste definições que XamlReader diferem das definições padrão.

Aplica-se a

Load(XmlReader)

Carrega uma implementação específica de leitor XML e devolve um grafo 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

A XmlReader implementação a usar como leitor para esta Load operação.

Devoluções

Object

O grafo de objetos de saída.

Exceções

ArgumentNullException

xmlReader a entrada é null.

Observações

Normalmente, deve usar esta assinatura apenas se tiver definido a sua própria implementação de um XmlReader.

Aplica-se a

Comentários

Esta página foi útil?