XamlServices.Load Méthode

Définition

Charge la source pour un lecteur XAML et écrit sa sortie sous la forme d'un graphique d'objet.

Surcharges

Load(Stream)

Charge une source Stream pour un lecteur XAML et écrit sa sortie sous la forme d'un graphique d'objet.

Load(TextReader)

Crée un lecteur XAML à partir d'un TextReader, et retourne un graphique d'objet.

Load(String)

Charge une source Stream 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 source Stream pour un lecteur XAML et écrit sa sortie sous la forme d'un graphique d'objet.

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 de données à charger en tant qu'entrée.

Retours

Object

Graphique d'objet écrit en tant que sortie.

Exceptions

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 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 graphe d’objets, 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 espace de noms XAML WPF comme 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

XamlServicesn’est pas le jeu d’API de lecture XAML ou d’écriture XAML recommandé si vous traitez des types Windows Presentation Foundation (WPF) ou des types basés sur WPF. Pour l’utilisation de WPF, utilisez-le 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 TextReader, 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 en tant que base pour le XmlReader créé.

Retours

Object

Graphique d'objet retourné.

Exceptions

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 élément construit à l’aide d’une entrée XAML-as-string valide pour le StringReader(String) constructeur.

S’applique à

Load(String)

Charge une source Stream 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 en tant que source.

Retours

Object

Graphique d'objet retourné.

Exceptions

L'entrée fileName est null.

Remarques

Différentes signatures pour la Load méthode spécifient différents types d’entrée pour le 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 graphe d’objets, 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 espace de noms XAML WPF comme spécifié dans le code XAML ; les assemblys pour WPF doivent être inclus dans le projet ou être disponibles au moment de l’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 opération Load.

Retours

Object

Graphique d'objet retourné.

Exceptions

L'entrée xamlReader 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 de XmlReader à utiliser comme lecteur pour cette opération Load.

Retours

Object

Graphique d'objet de sortie.

Exceptions

L'entrée xamlReader 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 à