XamlReader.LoadAsync Yöntem

Tanım

Ad Alanı:
System.Windows.Markup
Bütünleştirilmiş Kod:
PresentationFramework.dll

XAML işaretlemesini okur ve belirtilen işaretlemenin köküne karşılık gelen bir nesne döndürür.

Aşırı Yüklemeler

Name Description
LoadAsync(Stream, ParserContext, Boolean)
LoadAsync(XmlReader, Boolean)
LoadAsync(Stream, ParserContext)

Belirtilen Stream içindeki XAML girişini okur ve ilgili nesne ağacının kökünü döndürür.
LoadAsync(Stream)

Belirtilen Stream içindeki XAML girişini okur ve ilgili nesne ağacının kökünü döndürür.
LoadAsync(XmlReader)

Belirtilen XmlReader içindeki XAML girişini okur ve ilgili nesne ağacının kökünü döndürür.
LoadAsync(Stream, Boolean)

LoadAsync(Stream, ParserContext, Boolean) 

public:
 System::Object ^ LoadAsync(System::IO::Stream ^ stream, System::Windows::Markup::ParserContext ^ parserContext, bool useRestrictiveXamlReader);
public object LoadAsync(System.IO.Stream stream, System.Windows.Markup.ParserContext parserContext, bool useRestrictiveXamlReader);
member this.LoadAsync : System.IO.Stream * System.Windows.Markup.ParserContext * bool -> obj
Public Function LoadAsync (stream As Stream, parserContext As ParserContext, useRestrictiveXamlReader As Boolean) As Object

Parametreler

stream
Stream
parserContext
ParserContext
useRestrictiveXamlReader
Boolean

Döndürülenler

Object

Açıklamalar

Bu yöntem, yöntemin zaman uyumlu karşılık geleninin oluşturabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanırsa, görev beklendiğinde bu özel durum oluşturulur. ArgumentExceptiongibi kullanım özel durumları hâlâ eşzamanlı olarak fırlatılır. Depolanan özel durumlar için tarafından Load(Stream, ParserContext, Boolean)oluşan özel durumlara bakın.

Şunlara uygulanır

LoadAsync(XmlReader, Boolean) 

public:
 System::Object ^ LoadAsync(System::Xml::XmlReader ^ reader, bool useRestrictiveXamlReader);
public object LoadAsync(System.Xml.XmlReader reader, bool useRestrictiveXamlReader);
member this.LoadAsync : System.Xml.XmlReader * bool -> obj
Public Function LoadAsync (reader As XmlReader, useRestrictiveXamlReader As Boolean) As Object

Parametreler

reader
XmlReader
useRestrictiveXamlReader
Boolean

Döndürülenler

Object

Açıklamalar

Bu yöntem, yöntemin zaman uyumlu karşılık geleninin oluşturabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanırsa, görev beklendiğinde bu özel durum oluşturulur. ArgumentExceptiongibi kullanım özel durumları hâlâ eşzamanlı olarak fırlatılır. Depolanan özel durumlar için tarafından Load(XmlReader, Boolean)oluşan özel durumlara bakın.

Şunlara uygulanır

LoadAsync(Stream, ParserContext)

Belirtilen Stream içindeki XAML girişini okur ve ilgili nesne ağacının kökünü döndürür.

public:
 System::Object ^ LoadAsync(System::IO::Stream ^ stream, System::Windows::Markup::ParserContext ^ parserContext);
public object LoadAsync(System.IO.Stream stream, System.Windows.Markup.ParserContext parserContext);
member this.LoadAsync : System.IO.Stream * System.Windows.Markup.ParserContext -> obj
Public Function LoadAsync (stream As Stream, parserContext As ParserContext) As Object

Parametreler

stream
Stream

Yüklenecek XAML girişini içeren bir akış.

parserContext
ParserContext

Ayrıştırıcı tarafından kullanılan bağlam bilgileri.

Döndürülenler

Object

Oluşturulan nesne ağacının kökü.

Özel durumlar

ArgumentNullException

stream, null'e eşittir.

InvalidOperationException

Aynı XamlReaderile birden çok yük işlemi eşzamanlı olarak gerçekleştirilir.

Açıklamalar

Zaman uyumsuz bir XAML yükleme işlemi başlangıçta yalnızca kök nesne olan bir nesne döndürür. Zaman uyumsuz olarak, XAML ayrıştırma işlemi devam eder ve tüm alt nesneler kök altında doldurulur. Bu, tipik WPF XAML işleme davranışının ve nesne ömrü kavramlarıyla WPF etkileşiminin aksinedir. Tipik (zaman uyumsuz) etkileşimde, bir öğe döndürülmeden ve yüklendi olarak bildirilmeden önce tüm alt koleksiyonlar dahil olmak üzere bir nesnenin tüm özellikleri doldurulur. Bu davranış, kök nesnenin kullanılabilir olacak son nesne olduğu ağacı oluşturmak için bir alt düzey metodolojisine eşittir.

Döndürülen nesneyi genellikle uygulamanızın nesne ağacındaki bir konuma atarsınız; içeriğin doldurulmaya devam ediyor olabileceği ve içeriğin tamamı kullanıcı arabiriminin bir parçası olarak kullanıma sunulduğunda artımlı düzen güncelleştirmelerine neden olabilir. Bu nedenle, XAML'den zaman uyumsuz olarak yüklenen nesneleri yalıtmak veya sanallaştırmak ve işlendiğinde LoadCompleted bildirmek için uygulamaya özgü mantık veya uygulama durumu kullanmak normaldir.

İşaretlemeyi zaman uyumsuz olarak yüklemek için LoadAsync , XAML işaretlemesindeki kök öğesi özniteliğini ve değerini x:SynchronousMode="Async"içermelidir. Değer büyük/küçük harfe duyarlı olarak değerlendirilir. XAML işaretleme kökü içermiyorsa x:SynchronousMode="Async"özel durum oluşturmaz ve çağrı zaman uyumlu yük olarak işlenir (bkz Load(Stream, ParserContext). ).

Bir kerede sınıfın örneği XamlReader başına yalnızca bir zaman uyumsuz yük işlemi gerçekleştirilebilir. Sınıfın aynı örneğinde XamlReader birden fazla zaman uyumsuz işlem denenirse bir InvalidOperationException oluşturulur.

Bu yöntem, yöntemin zaman uyumlu karşılık geleninin oluşturabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanırsa, görev beklendiğinde bu özel durum oluşturulur. ArgumentExceptiongibi kullanım özel durumları hâlâ eşzamanlı olarak fırlatılır. Depolanan özel durumlar için tarafından Load(Stream, ParserContext)oluşan özel durumlara bakın.

Ayrıca bkz.

Şunlara uygulanır

LoadAsync(Stream)

Belirtilen Stream içindeki XAML girişini okur ve ilgili nesne ağacının kökünü döndürür.

public:
 System::Object ^ LoadAsync(System::IO::Stream ^ stream);
public object LoadAsync(System.IO.Stream stream);
member this.LoadAsync : System.IO.Stream -> obj
Public Function LoadAsync (stream As Stream) As Object

Parametreler

stream
Stream

Yüklenecek XAML girişini içeren akış.

Döndürülenler

Object

Oluşturulan nesne ağacının kökü olan nesne.

Özel durumlar

ArgumentNullException

stream, null'e eşittir.

InvalidOperationException

Aynı XamlReaderile aynı anda birden çok yük işlemi bekliyor.

Açıklamalar

Zaman uyumsuz bir XAML yükleme işlemi başlangıçta yalnızca kök nesne olan bir nesne döndürür. Zaman uyumsuz olarak, XAML ayrıştırma işlemi devam eder ve tüm alt nesneler kök altında doldurulur. Bu, tipik WPF XAML işleme davranışının ve nesne ömrü kavramlarıyla WPF etkileşiminin aksinedir. Tipik (zaman uyumsuz) etkileşimde, bir öğe döndürülmeden ve yüklendi olarak bildirilmeden önce tüm alt koleksiyonlar dahil olmak üzere bir nesnenin tüm özellikleri doldurulur. Bu davranış, kök nesnenin kullanılabilir olacak son nesne olduğu ağacı oluşturmak için bir alt düzey metodolojisine eşittir.

Döndürülen nesneyi genellikle WPF uygulamanızın nesne ağacındaki bir konuma atarsınız; içeriğin doldurulmaya devam edebilir ve tüm içerik kullanıcı arabiriminin bir parçası olarak kullanıma sunulduğunda artımlı düzen güncelleştirmelerine neden olabilir. Bu nedenle, XAML'den zaman uyumsuz olarak yüklenen nesneleri yalıtmak veya sanallaştırmak ve işlendiğinde LoadCompleted bildirmek için uygulamaya özgü mantık veya uygulama durumu kullanmak normaldir.

XAML girişini zaman uyumsuz olarak yüklemek için LoadAsync , XAML girişindeki kök öğesi özniteliğini ve değerini x:SynchronousMode="Async"içermelidir. Değer büyük/küçük harfe duyarlı olarak değerlendirilir. XAML giriş kökü içermiyorsa x:SynchronousMode="Async"özel durum oluşturmaz ve çağrı zaman uyumlu yük olarak işlenir (bkz Load(Stream). ).

Bir kerede sınıfın örneği XamlReader başına yalnızca bir zaman uyumsuz yük işlemi gerçekleştirilebilir. Sınıfın aynı örneğinde XamlReader birden fazla zaman uyumsuz işlem denenirse bir InvalidOperationException oluşturulur.

Bu yöntem, yöntemin zaman uyumlu karşılık geleninin oluşturabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanırsa, görev beklendiğinde bu özel durum oluşturulur. ArgumentExceptiongibi kullanım özel durumları hâlâ eşzamanlı olarak fırlatılır. Depolanan özel durumlar için tarafından Load(Stream)oluşan özel durumlara bakın.

Ayrıca bkz.

Şunlara uygulanır

LoadAsync(XmlReader)

Belirtilen XmlReader içindeki XAML girişini okur ve ilgili nesne ağacının kökünü döndürür.

public:
 System::Object ^ LoadAsync(System::Xml::XmlReader ^ reader);
public object LoadAsync(System.Xml.XmlReader reader);
member this.LoadAsync : System.Xml.XmlReader -> obj
Public Function LoadAsync (reader As XmlReader) As Object

Parametreler

reader
XmlReader

XAML girişini zaten yüklemiş/okumuş bir mevcut XmlReader .

Döndürülenler

Object

Oluşturulan nesne ağacının kökü.

Özel durumlar

ArgumentNullException

reader, null'e eşittir.

InvalidOperationException

Aynı XamlReaderile birden çok yük işlemi eşzamanlı olarak gerçekleştirilir.

Açıklamalar

Zaman uyumsuz bir XAML yükleme işlemi başlangıçta yalnızca kök nesne olan bir nesne döndürür. Zaman uyumsuz olarak, XAML ayrıştırma işlemi devam eder ve tüm alt nesneler kök altında doldurulur. Bu, tipik WPF XAML işleme davranışının ve nesne ömrü kavramlarıyla WPF etkileşiminin aksinedir. Tipik (zaman uyumsuz) etkileşimde, bir öğe döndürülmeden ve yüklendi olarak bildirilmeden önce tüm alt koleksiyonlar dahil olmak üzere bir nesnenin tüm özellikleri doldurulur. Bu davranış, kök nesnenin kullanılabilir olacak son nesne olduğu ağacı oluşturmak için bir alt düzey metodolojisine eşittir.

Döndürülen nesneyi genellikle uygulamanızın nesne LoadAsync ağacındaki bir konuma atarsınız; içeriğin doldurulmaya devam edebilir ve tüm içerik kullanıcı arabiriminin bir parçası olarak kullanıma sunulduğunda artımlı düzen güncelleştirmelerine neden olabilir. Bu nedenle, XAML'den zaman uyumsuz olarak yüklenen nesneleri yalıtmak veya sanallaştırmak ve işlendiğinde LoadCompleted bildirmek için uygulamaya özgü mantık veya uygulama durumu kullanmak normaldir.

XAML girişini zaman uyumsuz olarak yüklemek için LoadAsync , XAML işaretlemesindeki kök öğesi özniteliğini ve değerini x:SynchronousMode="Async"içermelidir. Değer büyük/küçük harfe duyarlı olarak değerlendirilir. XAML işaretleme kökü içermiyorsa x:SynchronousMode="Async"özel durum oluşturmaz ve bunun yerine çağrı zaman uyumlu yük olarak işlenir (bkz Load(XmlReader). ).

Bir kerede sınıfın örneği XamlReader başına yalnızca bir zaman uyumsuz yük işlemi gerçekleştirilebilir. Sınıfın aynı örneğinde XamlReader birden fazla zaman uyumsuz işlem denenirse bir InvalidOperationException oluşturulur.

Bu yöntem, yöntemin zaman uyumlu karşılık geleninin oluşturabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanırsa, görev beklendiğinde bu özel durum oluşturulur. ArgumentExceptiongibi kullanım özel durumları hâlâ eşzamanlı olarak fırlatılır. Depolanan özel durumlar için tarafından Load(XmlReader)oluşan özel durumlara bakın.

Ayrıca bkz.

Şunlara uygulanır

LoadAsync(Stream, Boolean) 

public:
 System::Object ^ LoadAsync(System::IO::Stream ^ stream, bool useRestrictiveXamlReader);
public object LoadAsync(System.IO.Stream stream, bool useRestrictiveXamlReader);
member this.LoadAsync : System.IO.Stream * bool -> obj
Public Function LoadAsync (stream As Stream, useRestrictiveXamlReader As Boolean) As Object

Parametreler

stream
Stream
useRestrictiveXamlReader
Boolean

Döndürülenler

Object

Açıklamalar

Bu yöntem, yöntemin zaman uyumlu karşılık geleninin oluşturabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanırsa, görev beklendiğinde bu özel durum oluşturulur. ArgumentExceptiongibi kullanım özel durumları hâlâ eşzamanlı olarak fırlatılır. Depolanan özel durumlar için tarafından Load(Stream, Boolean)oluşan özel durumlara bakın.

Şunlara uygulanır