XamlServices.Load Méthode
Définition
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 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
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
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
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
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
Retours
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.