Bahasa

XamlServices.Load Metode

Definisi

Memuat sumber untuk pembaca XAML dan menulis outputnya sebagai grafik objek.

Overload

Nama Deskripsi
Load(Stream)

Stream Memuat sumber untuk pembaca XAML dan menulis outputnya sebagai grafik objek.

Load(TextReader)

Membuat pembaca XAML dari TextReader, dan mengembalikan grafik objek.

Load(String)

Stream Memuat sumber untuk pembaca XAML dan mengembalikan grafik objek.

Load(XamlReader)

Memuat implementasi pembaca XAML tertentu dan mengembalikan grafik objek.

Load(XmlReader)

Memuat implementasi pembaca XML tertentu dan mengembalikan grafik objek.

Load(Stream)

Stream Memuat sumber untuk pembaca XAML dan menulis outputnya sebagai grafik objek.

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

Parameter

stream
Stream

Aliran untuk dimuat sebagai input.

Mengembalikan

Grafik objek yang ditulis sebagai output.

Pengecualian

stream adalah null.

Keterangan

Tanda tangan yang Load(Stream) berbeda untuk metode menentukan berbagai jenis input untuk XAML sumber. Implementasi Load(Stream) internal pertama-tama XmlReader membuat dengan memanggil Create(Stream) dan kemudian membuat instans baru dari khusus XamlReader yang memproses input.

Agar Load(Stream) panggilan berhasil membuat grafik objek, berikut ini harus benar:

  • Sumbernya dibentuk dengan baik dan XML yang valid.

  • Sumbernya adalah XAML yang valid di tingkat bahasa.

  • Jenis XAML yang ditentukan dalam XAML sumber harus diselesaikan ke jenis backing di namespace XAML yang relevan. Misalnya, jenis XAML untuk namespace WPF dapat diselesaikan ke namespace WPF XAML seperti yang ditentukan dalam XAML; rakitan untuk WPF harus disertakan dalam proyek atau tersedia dalam run time; dan sebagainya.

Important

XamlServices bukan pembacaan XAML yang direkomendasikan atau set API penulisan XAML jika Anda memproses jenis Windows Presentation Foundation (WPF), atau jenis berdasarkan WPF. Untuk penggunaan WPF, gunakan System.Windows.Markup.XamlReader untuk membaca atau memuat XAML; dan System.Windows.Markup.XamlWriter untuk menulis kembali XAML. Kelas-kelas ini menggunakan System.Xaml API secara internal dalam implementasinya; namun, mereka juga memberikan dukungan untuk konsep khusus WPF yang memengaruhi sifat pembacaan dan penulisan XAML, seperti pengoptimalan untuk properti dependensi.

Berlaku untuk

Load(TextReader)

Membuat pembaca XAML dari TextReader, dan mengembalikan grafik objek.

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

Parameter

textReader
TextReader

untuk TextReader digunakan sebagai dasar untuk yang dibuat XmlReader.

Mengembalikan

Grafik objek yang dikembalikan.

Pengecualian

textReader adalah null.

Keterangan

Untuk mengembalikan grafik objek, textReader input harus dibangun dengan menggunakan input yang relevan. Misalnya, harus melewati StringReader yang dibangun dengan menggunakan input XAML-as-string yang valid untuk StringReader(String) konstruktor.

Berlaku untuk

Load(String)

Stream Memuat sumber untuk pembaca XAML dan mengembalikan grafik objek.

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

Parameter

fileName
String

Nama file yang akan dimuat dan digunakan sebagai sumber.

Mengembalikan

Grafik objek yang dikembalikan.

Pengecualian

fileName input adalah null.

Keterangan

Tanda tangan yang Load berbeda untuk metode menentukan berbagai jenis input untuk XAML sumber. Implementasi Load internal pertama-tama XmlReader membuat dengan memanggil Create(String) dan kemudian membuat instans baru dari khusus XamlReader yang memproses input.

Agar Load(String) panggilan berhasil membuat grafik objek, berikut ini harus benar:

  • Sumbernya dibentuk dengan baik dan XML yang valid.

  • Sumbernya adalah XAML yang valid di tingkat bahasa.

  • Jenis XAML yang ditentukan dalam XAML sumber harus diselesaikan ke jenis backing di namespace XAML yang relevan. Misalnya, jenis XAML untuk namespace WPF dapat diselesaikan ke namespace WPF XAML seperti yang ditentukan dalam XAML; rakitan untuk WPF harus disertakan dalam proyek atau tersedia dalam waktu proses; dan sebagainya.

Berlaku untuk

Load(XamlReader)

Memuat implementasi pembaca XAML tertentu dan mengembalikan grafik objek.

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

Parameter

xamlReader
XamlReader

Implementasi pembaca XAML untuk digunakan sebagai pembaca untuk operasi ini Load .

Mengembalikan

Grafik objek yang dikembalikan.

Pengecualian

xamlReader input adalah null.

Keterangan

Anda biasanya harus menggunakan tanda tangan ini hanya dalam kasus berikut:

  • Anda mendefinisikan implementasi Anda sendiri dari XamlReader.

  • Anda menentukan pengaturan untuk yang XamlReader berbeda dari pengaturan default.

Berlaku untuk

Load(XmlReader)

Memuat implementasi pembaca XML tertentu dan mengembalikan grafik objek.

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

Parameter

xmlReader
XmlReader

Implementasi XmlReader yang digunakan sebagai pembaca untuk operasi ini Load .

Mengembalikan

Grafik objek output.

Pengecualian

xmlReader input adalah null.

Keterangan

Anda biasanya harus menggunakan tanda tangan ini hanya jika Anda menentukan implementasi Anda sendiri dari XmlReader.

Berlaku untuk