DataObject.GetData Metode

Definisi

Ruang nama:: System.Windows

Rakitan:: PresentationCore.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mengembalikan data dalam format data tertentu.

Overload

Nama	Deskripsi
GetData(String)	Mengembalikan data dalam format yang ditentukan oleh string.
GetData(Type)	Mengembalikan objek data dalam format yang ditentukan oleh Type objek.
GetData(String, Boolean)	Mengembalikan objek data dalam format tertentu, secara opsional mengonversi data ke format yang ditentukan.

GetData(String)

Mengembalikan data dalam format yang ditentukan oleh string.

public:
 virtual System::Object ^ GetData(System::String ^ format);

public object GetData(string format);

public object? GetData(string format);

abstract member GetData : string -> obj
override this.GetData : string -> obj

Public Function GetData (format As String) As Object

Parameter

format: String

String yang menentukan format untuk data. Untuk sekumpulan format data yang telah ditentukan sebelumnya, lihat DataFormats kelas .

Mengembalikan

Object

Objek yang berisi data dalam format yang ditentukan, atau null jika data tidak tersedia dalam format yang ditentukan.

Penerapan

GetData(String)

Pengecualian

ArgumentNullException

format adalah null.

Contoh

Contoh berikut menggunakan metode ini untuk terlebih dahulu memeriksa apakah format data tertentu tersedia (secara asli atau dengan konversi otomatis); jika format yang ditentukan tersedia, contoh mengambil data dengan menggunakan GetData(String) metode .

DataObject dataObject = new DataObject("Some string data to store...");

string desiredFormat = DataFormats.UnicodeText;
byte[] data = null;

// Use the GetDataPresent method to check for the presence of a desired data format.
// This particular overload of GetDataPresent looks for both native and auto-convertible 
// data formats.
if (dataObject.GetDataPresent(desiredFormat))
{
    // If the desired data format is present, use one of the GetData methods to retrieve the
    // data from the data object.
    data = dataObject.GetData(desiredFormat) as byte[];
}

Dim dataObject As New DataObject("Some string data to store...")

Dim desiredFormat As String = DataFormats.UnicodeText
Dim data() As Byte = Nothing

' Use the GetDataPresent method to check for the presence of a desired data format.
' This particular overload of GetDataPresent looks for both native and auto-convertible 
' data formats.
If dataObject.GetDataPresent(desiredFormat) Then
    ' If the desired data format is present, use one of the GetData methods to retrieve the
    ' data from the data object.
    data = TryCast(dataObject.GetData(desiredFormat), Byte())
End If

Contoh kode berikut menggunakan GetDataPresent(String, Boolean) metode untuk terlebih dahulu memeriksa apakah format data tertentu tersedia secara asli (format data yang dapat dikonversi otomatis difilter); jika format yang ditentukan tersedia, contoh mengambil data dengan menggunakan GetData(String) metode .

DataObject dataObject = new DataObject("Some string data to store...");

string desiredFormat = DataFormats.UnicodeText;
bool noAutoConvert = false;
byte[] data = null;

// Use the GetDataPresent method to check for the presence of a desired data format.
// The autoconvert parameter is set to false to filter out auto-convertible data formats,
// returning true only if the specified data format is available natively.
if (dataObject.GetDataPresent(desiredFormat, noAutoConvert))
{
    // If the desired data format is present, use one of the GetData methods to retrieve the
    // data from the data object.
    data = dataObject.GetData(desiredFormat) as byte[];
}

Dim dataObject As New DataObject("Some string data to store...")

Dim desiredFormat As String = DataFormats.UnicodeText
Dim noAutoConvert As Boolean = False
Dim data() As Byte = Nothing

' Use the GetDataPresent method to check for the presence of a desired data format.
' The autoconvert parameter is set to false to filter out auto-convertible data formats,
' returning true only if the specified data format is available natively.
If dataObject.GetDataPresent(desiredFormat, noAutoConvert) Then
    ' If the desired data format is present, use one of the GetData methods to retrieve the
    ' data from the data object.
    data = TryCast(dataObject.GetData(desiredFormat), Byte())
End If

Lihat juga

Memuat Sampel File yang Dihilangkan

Berlaku untuk

GetData(Type)

Mengembalikan objek data dalam format yang ditentukan oleh Type objek.

public:
 virtual System::Object ^ GetData(Type ^ format);

public object GetData(Type format);

public object? GetData(Type format);

abstract member GetData : Type -> obj
override this.GetData : Type -> obj

Public Function GetData (format As Type) As Object

Parameter

format: Type

Type Yang menentukan format untuk data. Untuk sekumpulan format data yang telah ditentukan sebelumnya, lihat DataFormats kelas .

Mengembalikan

Object

Objek data dengan data dalam format yang ditentukan, atau null jika data tidak tersedia dalam format yang ditentukan.

Penerapan

GetData(Type)

Pengecualian

ArgumentNullException

format adalah null.

Lihat juga

Memuat Sampel File yang Dihilangkan

Berlaku untuk

GetData(String, Boolean)

Mengembalikan objek data dalam format tertentu, secara opsional mengonversi data ke format yang ditentukan.

public:
 virtual System::Object ^ GetData(System::String ^ format, bool autoConvert);

public object GetData(string format, bool autoConvert);

public object? GetData(string format, bool autoConvert);

abstract member GetData : string * bool -> obj
override this.GetData : string * bool -> obj

Public Function GetData (format As String, autoConvert As Boolean) As Object

Parameter

format: String

String yang menentukan format untuk data. Untuk sekumpulan format data yang telah ditentukan sebelumnya, lihat DataFormats kelas .

autoConvert: Boolean

true untuk mencoba mengonversi data secara otomatis ke format yang ditentukan; false tanpa konversi format data.

Mengembalikan

Object

Objek data dengan data dalam format yang ditentukan, atau null jika data tidak tersedia dalam format yang ditentukan.

autoConvert Jika parameter adalah true dan data tidak dapat dikonversi ke format yang ditentukan, atau jika konversi otomatis dinonaktifkan (dengan memanggil SetData(String, Object, Boolean) dengan parameter yang autoConvert diatur ke false), metode ini mengembalikan null.

Penerapan

GetData(String, Boolean)

Pengecualian

ArgumentNullException

format null.

Lihat juga

Memuat Sampel File yang Dihilangkan

Berlaku untuk

Saran dan Komentar

Apakah halaman ini membantu?