Aracılığıyla paylaş

XamlReader.LoadAsync Yöntem

  • Başvuru

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

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

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

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

Belirtilen XmlReader içindeki XAML girişini okur ve karşılık gelen 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 atabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanıyorsa, görev beklenirken bu özel durum oluşturulur. gibi ArgumentExceptionkullanım özel durumları yine de zaman uyumlu olarak oluşturulur. Depolanan özel durumlar için tarafından oluşan Load(Stream, ParserContext, Boolean)ö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 atabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanıyorsa, görev beklenirken bu özel durum oluşturulur. gibi ArgumentExceptionkullanım özel durumları yine de zaman uyumlu olarak oluşturulur. Depolanan özel durumlar için tarafından oluşan Load(XmlReader, Boolean)özel durumlara bakın.

Şunlara uygulanır

LoadAsync(Stream, ParserContext)

Belirtilen Stream içindeki XAML girişini okur ve karşılık gelen 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üklenemiyor 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 değeridir.

InvalidOperationException

Birden çok yük işlemi aynı XamlReaderile 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ünün WPF kavramlarıyla 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 duruma gelen son nesne olduğu ağacı oluşturmaya yönelik bir alt-yukarı metodolojisine eşit olur.

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 tüm içerik kullanıcı arabiriminin bir parçası olarak kullanıma sunulduğunda artımlı düzen güncelleştirmelerine neden olabileceği bilgisini verirsiniz. Bu nedenle, XAML'den zaman uyumsuz olarak yüklenen nesneleri yalıtmak veya sanallaştırmak ve işlendiğinde LoadCompleted bunu 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ı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 atabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanıyorsa, görev beklenirken bu özel durum oluşturulur. gibi ArgumentExceptionkullanım özel durumları yine de zaman uyumlu olarak oluşturulur. Depolanan özel durumlar için tarafından oluşan Load(Stream, ParserContext)özel durumlara bakın.

Ayrıca bkz.

Şunlara uygulanır

LoadAsync(Stream)

Belirtilen Stream içindeki XAML girişini okur ve karşılık gelen 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üklenemiyor 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 değeridir.

InvalidOperationException

Aynı ile XamlReaderaynı anda birden çok yükleme işlemi bekleniyor.

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ünün WPF kavramlarıyla 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 duruma gelen son nesne olduğu ağacı oluşturmaya yönelik bir alt-yukarı metodolojisine eşit olur.

Döndürülen nesneyi genellikle WPF uygulamanızın nesne ağacındaki bir konuma atarsınız; içeriğin doldurulmaya devam ediyor olabileceği ve tüm içerik kullanıcı arabiriminin bir parçası olarak kullanıma sunulduğunda artımlı düzen güncelleştirmelerine neden olabileceği bilgisini verirsiniz. Bu nedenle, XAML'den zaman uyumsuz olarak yüklenen nesneleri yalıtmak veya sanallaştırmak ve işlendiğinde LoadCompleted bunu 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ı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 atabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanıyorsa, görev beklenirken bu özel durum oluşturulur. gibi ArgumentExceptionkullanım özel durumları yine de zaman uyumlu olarak oluşturulur. Depolanan özel durumlar için tarafından oluşan Load(Stream)özel durumlara bakın.

Ayrıca bkz.

Şunlara uygulanır

LoadAsync(XmlReader)

Belirtilen XmlReader içindeki XAML girişini okur ve karşılık gelen 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 değeridir.

InvalidOperationException

Birden çok yük işlemi aynı XamlReaderile 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ünün WPF kavramlarıyla 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 duruma gelen son nesne olduğu ağacı oluşturmaya yönelik bir alt-yukarı metodolojisine eşit olur.

Döndürülen nesneyi LoadAsync genellikle uygulamanızın nesne ağacındaki bir konuma atarsınız; içeriğin doldurulmaya devam ediyor olabileceği ve tüm içerik kullanıcı arabiriminin bir parçası olarak kullanıma sunulduğunda artımlı düzen güncelleştirmelerine neden olabileceği bilgisini verirsiniz. Bu nedenle, XAML'den zaman uyumsuz olarak yüklenen nesneleri yalıtmak veya sanallaştırmak ve işlendiğinde LoadCompleted bunu 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 çağrı bunun yerine 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ı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 atabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanıyorsa, görev beklenirken bu özel durum oluşturulur. gibi ArgumentExceptionkullanım özel durumları yine de zaman uyumlu olarak oluşturulur. Depolanan özel durumlar için tarafından oluşan Load(XmlReader)ö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 atabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanıyorsa, görev beklenirken bu özel durum oluşturulur. gibi ArgumentExceptionkullanım özel durumları yine de zaman uyumlu olarak oluşturulur. Depolanan özel durumlar için tarafından oluşan Load(Stream, Boolean)özel durumlara bakın.

Şunlara uygulanır