XamlServices.Load Método

Definição

Namespace:: System.Xaml

Assembly:: System.Xaml.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Carrega a origem de um leitor XAML e grava sua saída como um grafo de objeto.

Sobrecargas

Nome	Description
Load(Stream)	Carrega uma Stream origem para um leitor XAML e grava sua saída como um grafo de objeto.
Load(TextReader)	Cria um leitor XAML de um TextReadere retorna um grafo de objeto.
Load(String)	Carrega uma Stream origem para um leitor XAML e retorna um grafo de objeto.
Load(XamlReader)	Carrega uma implementação de leitor XAML específica e retorna um grafo de objeto.
Load(XmlReader)	Carrega uma implementação de leitor XML específica e retorna um grafo de objeto.

Load(Stream)

Carrega uma Stream origem para um leitor XAML e grava sua saída como um grafo 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 grafo de objeto que é gravado como saída.

Exceções

ArgumentNullException

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 por chamada Create(Stream) e, em seguida, cria uma nova instância de um especializado que processa XamlReader a entrada.

Para que a Load(Stream) chamada crie com êxito um grafo de objeto, 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 backup nos namespaces XAML relevantes. Por exemplo, tipos XAML para namespaces WPF podem ser resolvidos para um namespace XAML WPF conforme especificado no XAML; os assemblies para WPF devem ser incluídos no projeto ou disponíveis no tempo de execução; e assim por diante.

Importante

XamlServices não é a leitura XAML recomendada ou o conjunto de API de gravação XAML se você estiver processando tipos do WPF (Windows Presentation Foundation) 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 XAML de um TextReadere retorna um grafo 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 criado XmlReader.

Retornos

Object

O grafo de objeto retornado.

Exceções

ArgumentNullException

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 uma Stream origem para um leitor XAML e retorna um grafo 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 retornado.

Exceções

ArgumentNullException

fileName a entrada é 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 por chamada Create(String) e, em seguida, cria uma nova instância de um especializado que processa XamlReader a entrada.

Para que a Load(String) chamada crie com êxito um grafo de objeto, 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 backup nos namespaces XAML relevantes. Por exemplo, tipos XAML para namespaces WPF podem ser resolvidos para um namespace XAML WPF conforme especificado no XAML; os assemblies para 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 de leitor XAML específica e retorna um grafo 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 XAML a ser usada como leitor para esta Load operação.

Retornos

Object

O grafo de objeto retornado.

Exceções

ArgumentNullException

xamlReader a entrada é 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 de leitor XML específica e retorna um grafo 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 XmlReader implementação a ser usada como leitor para esta Load operação.

Retornos

Object

O grafo do objeto de saída.

Exceções

ArgumentNullException

xmlReader a entrada é null.

Comentários

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

Aplica-se a

Comentários

Esta página foi útil?