XamlServices.Load Méthode

Définition

Espace de noms:: System.Xaml

Assembly:: System.Xaml.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Charge la source d’un lecteur XAML et écrit sa sortie en tant que graphe d’objets.

Surcharges

Nom	Description
Load(Stream)	Charge une Stream source pour un lecteur XAML et écrit sa sortie en tant que graphe d’objets.
Load(TextReader)	Crée un lecteur XAML à partir d’un TextReadergraphique d’objets et retourne un graphique d’objet.
Load(String)	Charge une Stream source pour un lecteur XAML et retourne un graphique d’objet.
Load(XamlReader)	Charge une implémentation de lecteur XAML spécifique et retourne un graphique d’objet.
Load(XmlReader)	Charge une implémentation de lecteur XML spécifique et retourne un graphique d’objet.

Load(Stream)

Charge une Stream source pour un lecteur XAML et écrit sa sortie en tant que graphe d’objets.

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

Paramètres

stream: Stream

Flux à charger en tant qu’entrée.

Retours

Object

Graphique d’objet écrit en tant que sortie.

Exceptions

ArgumentNullException

stream a la valeur null.

Remarques

Différentes signatures pour la Load(Stream) méthode spécifient différents types d’entrée pour le code XAML source. L’implémentation Load(Stream) interne crée d’abord un XmlReader appel Create(Stream) , puis crée une instance d’une instance spécialisée XamlReader qui traite l’entrée.

Pour que l’appel Load(Stream) crée correctement un graphique d’objet, les éléments suivants doivent être vrais :

La source est bien formée et valide XML.
La source est xaml valide au niveau du langage.
Les types XAML spécifiés dans le code XAML source doivent être résolus en types de stockage dans les espaces de noms XAML appropriés. Par exemple, les types XAML pour WPF espaces de noms peuvent être résolus en un espace de noms XAML WPF tel que spécifié dans le code XAML ; les assemblys pour WPF doivent être inclus dans le projet ou disponibles dans le temps d’exécution, et ainsi de suite.

Important

XamlServices n’est pas le jeu d’API de lecture XAML ou d’écriture XAML recommandé si vous traitez des types WPF (Windows Presentation Foundation) ou des types basés sur WPF. Pour l’utilisation de WPF, utilisez-la System.Windows.Markup.XamlReader pour lire ou charger du code XAML et System.Windows.Markup.XamlWriter pour écrire du code XAML. Ces classes utilisent System.Xaml des API en interne dans leur implémentation. Toutefois, elles prennent également en charge les concepts spécifiques à WPF qui influencent la nature de la lecture et de l’écriture XAML, telles que les optimisations pour les propriétés de dépendance.

S’applique à

Load(TextReader)

Crée un lecteur XAML à partir d’un TextReadergraphique d’objets et retourne un graphique d’objet.

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

Paramètres

textReader: TextReader

À TextReader utiliser comme base pour la création XmlReader.

Retours

Object

Graphique d’objet retourné.

Exceptions

ArgumentNullException

textReader a la valeur null.

Remarques

Pour retourner le graphique d’objet, l’entrée textReader doit être construite à l’aide de son entrée pertinente. Par exemple, il doit passer un StringReader qui est construit à l’aide d’une entrée XAML en tant que chaîne valide pour le StringReader(String) constructeur.

S’applique à

Load(String)

Charge une Stream source pour un lecteur XAML et retourne un graphique d’objet.

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

Paramètres

fileName: String

Nom de fichier à charger et utiliser comme source.

Retours

Object

Graphique d’objet retourné.

Exceptions

ArgumentNullException

fileName entrée est null.

Remarques

Différentes signatures pour la Load méthode spécifient différents types d’entrée pour le code XAML source. L’implémentation Load interne crée d’abord un XmlReader appel Create(String) , puis crée une instance d’une instance spécialisée XamlReader qui traite l’entrée.

Pour que l’appel Load(String) crée correctement un graphique d’objet, les éléments suivants doivent être vrais :

La source est bien formée et valide XML.
La source est xaml valide au niveau du langage.
Les types XAML spécifiés dans le code XAML source doivent être résolus en types de stockage dans les espaces de noms XAML appropriés. Par exemple, les types XAML pour les espaces de noms WPF peuvent être résolus en un espace de noms XAML WPF tel que spécifié dans le code XAML ; les assemblys pour WPF doivent être inclus dans le projet ou être disponibles dans le temps d’exécution, et ainsi de suite.

S’applique à

Load(XamlReader)

Charge une implémentation de lecteur XAML spécifique et retourne un graphique d’objet.

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

Paramètres

xamlReader: XamlReader

Implémentation du lecteur XAML à utiliser comme lecteur pour cette Load opération.

Retours

Object

Graphique d’objet retourné.

Exceptions

ArgumentNullException

xamlReader entrée est null.

Remarques

Vous devez généralement utiliser cette signature uniquement dans les cas suivants :

Vous avez défini votre propre implémentation d’un XamlReader.
Vous avez spécifié les paramètres d’un XamlReader paramètre différent des paramètres par défaut.

S’applique à

Load(XmlReader)

Charge une implémentation de lecteur XML spécifique et retourne un graphique d’objet.

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

Paramètres

xmlReader: XmlReader

Implémentation XmlReader à utiliser comme lecteur pour cette Load opération.

Retours

Object

Graphique d’objet de sortie.

Exceptions

ArgumentNullException

xmlReader entrée est null.

Remarques

Vous devez généralement utiliser cette signature uniquement si vous avez défini votre propre implémentation d’un XmlReader.

S’applique à

Commentaires

Cette page a-t-elle été utile ?