XamlServices.Load Metod

Definition

Namnområde:
System.Xaml
Sammansättning:
System.Xaml.dll

Läser in källan för en XAML-läsare och skriver dess utdata som ett objektdiagram.

Överlagringar

Name Description
Load(Stream)

Läser in en Stream källa för en XAML-läsare och skriver utdata som ett objektdiagram.
Load(TextReader)

Skapar en XAML-läsare från en TextReader, och returnerar ett objektdiagram.
Load(String)

Läser in en Stream källa för en XAML-läsare och returnerar ett objektdiagram.
Load(XamlReader)

Läser in en specifik XAML-läsareimplementering och returnerar ett objektdiagram.
Load(XmlReader)

Läser in en specifik XML-läsareimplementering och returnerar ett objektdiagram.

Load(Stream)

Läser in en Stream källa för en XAML-läsare och skriver utdata som ett objektdiagram.

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

Parametrar

stream
Stream

Strömmen som ska läsas in som indata.

Returer

Object

Objektdiagrammet som skrivs som utdata.

Undantag

ArgumentNullException

stream är null.

Kommentarer

Olika signaturer för Load(Stream) metoden anger olika typer av indata för käll-XAML. Den Load(Stream) interna implementeringen skapar först ett XmlReader genom att anropa Create(Stream) och skapar sedan en ny instans av en specialiserad XamlReader som bearbetar indata.

För att anropet Load(Stream) ska kunna skapa ett objektdiagram måste följande vara sant:

  • Källan är välformulerad och giltig XML.

  • Källan är giltig XAML på språknivå.

  • De XAML-typer som anges i XAML-källan måste matchas mot bakgrundstyper i relevanta XAML-namnområden. Till exempel kan XAML-typer för WPF namnområden matchas mot ett WPF XAML-namnområde som anges i XAML. Sammansättningarna för WPF måste ingå i projektet eller vara tillgängliga under körningstiden och så vidare.

Important

XamlServices är inte den rekommenderade API-uppsättningen för XAML-läsning eller XAML-skrivning om du bearbetar Windows Presentation Foundation-typer (WPF) eller typer baserat på WPF. För WPF användning använder du System.Windows.Markup.XamlReader för att läsa eller läsa in XAML och System.Windows.Markup.XamlWriter för att skriva tillbaka XAML. Dessa klasser använder System.Xaml API:er internt i implementeringen. Men de ger också stöd för WPF-specifika begrepp som påverkar typen av XAML-läsning och skrivning, till exempel optimeringar för beroendeegenskaper.

Gäller för

Load(TextReader)

Skapar en XAML-läsare från en TextReader, och returnerar ett objektdiagram.

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

Parametrar

textReader
TextReader

Att TextReader använda som grund för den skapade XmlReader.

Returer

Object

Objektdiagrammet som returneras.

Undantag

ArgumentNullException

textReader är null.

Kommentarer

För att returnera objektdiagrammet textReader bör indata konstrueras med hjälp av relevanta indata. Den bör till exempel skicka en StringReader som är konstruerad med hjälp av en giltig XAML-as-string-indata för StringReader(String) konstruktorn.

Gäller för

Load(String)

Läser in en Stream källa för en XAML-läsare och returnerar ett objektdiagram.

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

Parametrar

fileName
String

Filnamnet som ska läsas in och användas som källa.

Returer

Object

Objektdiagrammet som returneras.

Undantag

ArgumentNullException

fileName indata är null.

Kommentarer

Olika signaturer för Load metoden anger olika typer av indata för käll-XAML. Den Load interna implementeringen skapar först ett XmlReader genom att anropa Create(String) och skapar sedan en ny instans av en specialiserad XamlReader som bearbetar indata.

För att anropet Load(String) ska kunna skapa ett objektdiagram måste följande vara sant:

  • Källan är välformulerad och giltig XML.

  • Källan är giltig XAML på språknivå.

  • De XAML-typer som anges i XAML-källan måste matchas mot bakgrundstyper i relevanta XAML-namnområden. Till exempel kan XAML-typer för WPF namnområden matcha till ett WPF XAML-namnområde som anges i XAML. Sammansättningarna för WPF måste ingå i projektet eller vara tillgängliga under körningstiden och så vidare.

Gäller för

Load(XamlReader)

Läser in en specifik XAML-läsareimplementering och returnerar ett objektdiagram.

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

Parametrar

xamlReader
XamlReader

XAML-läsarimplementeringen som ska användas som läsare för den här Load åtgärden.

Returer

Object

Objektdiagrammet som returneras.

Undantag

ArgumentNullException

xamlReader indata är null.

Kommentarer

Du bör vanligtvis endast använda den här signaturen i följande fall:

  • Du har definierat din egen implementering av en XamlReader.

  • Du har angett inställningar för en XamlReader som skiljer sig från standardinställningarna.

Gäller för

Load(XmlReader)

Läser in en specifik XML-läsareimplementering och returnerar ett objektdiagram.

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

Parametrar

xmlReader
XmlReader

Implementeringen XmlReader som ska användas som läsare för den här Load åtgärden.

Returer

Object

Objektdiagrammet för utdata.

Undantag

ArgumentNullException

xmlReader indata är null.

Kommentarer

Du bör vanligtvis bara använda den här signaturen om du har definierat din egen implementering av en XmlReader.

Gäller för