XamlServices.Load Méthode

  • Référence

Définition

Espace de noms:
System.Xaml
Assembly:
System.Xaml.dll

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

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 XAML source. L’implémentation Load(Stream) interne crée d’abord un en XmlReader appelant Create(Stream) , puis crée une nouvelle instance d’un spécialiste XamlReader qui traite l’entrée.

Pour que l’appel Load(Stream) crée correctement un graphe d’objets, les éléments suivants doivent avoir la valeur true :

  • La source est un code XML valide et bien formé.

  • La source est DU XAML valide au niveau de la langue.

  • 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 se résoudre en espace de noms XAML WPF comme spécifié dans le XAML ; les assemblys pour WPF doivent être inclus dans le projet ou disponibles au moment de l’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 System.Windows.Markup.XamlReader pour la lecture ou le chargement DE XAML et System.Windows.Markup.XamlWriter pour l’écriture xaml. Ces classes utilisent System.Xaml des API en interne dans leur implémentation; toutefois, elles prennent également en charge les concepts propres à WPF qui influencent la nature de la lecture et de l’écriture XAML, comme les optimisations des 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

ArgumentNullException

textReader a la valeur null.

Remarques

Pour retourner le graphe d’objets, l’entrée doit être construite à l’aide textReader de son entrée appropriée. Par exemple, il doit passer un StringReader qui est 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

ArgumentNullException

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 en XmlReader appelant Create(String) , puis crée une nouvelle instance d’un spécialiste XamlReader qui traite l’entrée.

Pour que l’appel Load(String) crée correctement un graphe d’objets, les éléments suivants doivent avoir la valeur true :

  • La source est un code XML valide et bien formé.

  • La source est DU XAML valide au niveau de la langue.

  • 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 se résoudre en espace de noms XAML WPF comme spécifié dans le 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

ArgumentNullException

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é des paramètres pour un XamlReader qui 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

ArgumentNullException

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 à