Aracılığıyla paylaş


DataObject Sınıf

Tanım

Verileri aktarmak için biçim bağımsız bir mekanizma tanımlayan arabirimin IDataObject temel bir uygulamasını sağlar.

public ref class DataObject sealed : System::Runtime::InteropServices::ComTypes::IDataObject, System::Windows::IDataObject
public sealed class DataObject : System.Runtime.InteropServices.ComTypes.IDataObject, System.Windows.IDataObject
type DataObject = class
    interface IDataObject
    interface IDataObject
Public NotInheritable Class DataObject
Implements IDataObject, IDataObject
Devralma
DataObject
Uygulamalar

Örnekler

Aşağıdaki örnekte bu sınıfın nasıl kullanılacağı gösterilmektedir.

string stringData = "Some string data to store...";
string dataFormat = DataFormats.UnicodeText;
DataObject dataObject = new DataObject(dataFormat, stringData);
Dim stringData As String = "Some string data to store..."
Dim dataFormat As String = DataFormats.UnicodeText
Dim dataObject As New DataObject(dataFormat, stringData)

Açıklamalar

Önemli

Güvenilmeyen verilerle bu sınıftan yöntemleri çağırmak bir güvenlik riskidir. Bu sınıftaki yöntemleri yalnızca güvenilen verilerle çağırın. Daha fazla bilgi için bkz. Tüm Girişleri Doğrulama.

Oluşturucular

DataObject()

DataObject sınıfının yeni bir örneğini başlatır.

DataObject(Object)

Belirtilen verileri içeren sınıfının yeni bir örneğini DataObject başlatır.

DataObject(String, Object)

Belirtilen verileri ve ilişkili biçimini içeren sınıfının yeni bir örneğini DataObject başlatır; biçim bir dize tarafından belirtilir.

DataObject(String, Object, Boolean)

Belirtilen verileri ve ilişkili biçimini içeren sınıfının yeni bir örneğini DataObject başlatır; biçim bir dize tarafından belirtilir. Bu aşırı yükleme, verilerin alınırken başka bir biçime dönüştürülip dönüştürülemeyeceğini belirten bir Boolean bayrak içerir.

DataObject(Type, Object)

Belirtilen verileri ve ilişkili biçimini içeren sınıfının yeni bir örneğini DataObject başlatır; veri biçimi bir Type nesne tarafından belirtilir.

Alanlar

CopyingEvent

Ekli Copying olayı tanımlar.

PastingEvent

Ekli Pasting olayı tanımlar.

SettingDataEvent

Ekli SettingData olayı tanımlar.

Yöntemler

AddCopyingHandler(DependencyObject, DataObjectCopyingEventHandler)

Belirtilen bağımlılık Copying nesnesine olay işleyicisi ekler.

AddPastingHandler(DependencyObject, DataObjectPastingEventHandler)

Belirtilen bağımlılık Pasting nesnesine olay işleyicisi ekler.

AddSettingDataHandler(DependencyObject, DataObjectSettingDataEventHandler)

Belirtilen bağımlılık SettingData nesnesine olay işleyicisi ekler.

ContainsAudio()

Veri biçimindeki verilerin varlığı için bir veri WaveAudio nesnesini sorgular.

ContainsFileDropList()

Veri biçimindeki verilerin varlığı için bir veri FileDrop nesnesini sorgular.

ContainsImage()

Veri biçimindeki verilerin varlığı için bir veri Bitmap nesnesini sorgular.

ContainsText()

Biçimdeki verilerin varlığı için bir veri UnicodeText nesnesini sorgular.

ContainsText(TextDataFormat)

Metin veri biçimindeki verilerin varlığı için bir veri nesnesini sorgular.

Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.

(Devralındığı yer: Object)
GetAudioStream()

Veri biçimindeki verileri WaveAudio içeren bir akış döndürür.

GetData(String)

Verileri bir dize tarafından belirtilen biçimde döndürür.

GetData(String, Boolean)

Verileri isteğe bağlı olarak belirtilen biçime dönüştürerek, belirtilen biçimde bir veri nesnesi döndürür.

GetData(Type)

Bir nesne tarafından belirtilen biçimde bir Type veri nesnesi döndürür.

GetDataPresent(String)

Verilerin bir dize tarafından belirtilen biçimde kullanılıp kullanılamayacağını veya dönüştürülebileceğini belirler.

GetDataPresent(String, Boolean)

Verilerin belirtilen biçimde kullanılıp kullanılamayacağını veya dönüştürülebileceğini belirler. Bayrak Boolean , verilerin belirtilen biçimde yoksa belirtilen biçime dönüştürülip dönüştürülemeyeceğinin denetlenip denetlenmeyeceğini gösterir.

GetDataPresent(Type)

Verilerin bir nesne tarafından Type belirtilen biçimde kullanılıp kullanılamayacağını veya dönüştürülebileceğini belirler.

GetFileDropList()

Bırakılan dosyaların listesini içeren bir dize koleksiyonu döndürür.

GetFormats()

Bu veri nesnesindeki verilerin depolandığı veya dönüştürülebileceği biçimlerin listesini döndürür.

GetFormats(Boolean)

Bu veri nesnesindeki verilerin depolandığı biçimlerin listesini döndürür. Bayrak Boolean , verilerin otomatik olarak dönüştürülebileceği biçimlerin de eklenip eklenmeyeceğini belirtir.

GetHashCode()

Varsayılan karma işlevi işlevi görür.

(Devralındığı yer: Object)
GetImage()

Biçiminde veri Bitmap içeren bir BitmapSource nesne döndürür.

GetText()

Bu veri nesnesindeki UnicodeText verileri içeren bir dize döndürür.

GetText(TextDataFormat)

Bu veri nesnesinde belirtilen biçimdeki metin verilerini içeren bir dize döndürür.

GetType()

Type Geçerli örneğini alır.

(Devralındığı yer: Object)
MemberwiseClone()

Geçerli Objectöğesinin sığ bir kopyasını oluşturur.

(Devralındığı yer: Object)
RemoveCopyingHandler(DependencyObject, DataObjectCopyingEventHandler)

Belirtilen bağımlılık Copying nesnesinden olay işleyicisini kaldırır.

RemovePastingHandler(DependencyObject, DataObjectPastingEventHandler)

Belirtilen bağımlılık Pasting nesnesinden olay işleyicisini kaldırır.

RemoveSettingDataHandler(DependencyObject, DataObjectSettingDataEventHandler)

Belirtilen bağımlılık SettingData nesnesinden olay işleyicisini kaldırır.

SetAudio(Byte[])

Ses verilerini (WaveAudio veri biçimi) bu veri nesnesinde depolar. Ses verileri bir bayt dizisi olarak belirtilir.

SetAudio(Stream)

Ses verilerini (WaveAudio veri biçimi) bu veri nesnesinde depolar. Ses verileri akış olarak belirtilir.

SetData(Object)

Belirtilen verileri bu veri nesnesinde depolar ve kaynak nesne türünden veri biçimini otomatik olarak belirler.

SetData(String, Object)

Belirtilen verileri bir veya daha fazla belirtilen veri biçimiyle birlikte bu veri nesnesinde depolar; veri biçimi bir dize tarafından belirtilir.

SetData(String, Object, Boolean)

Belirtilen verileri bir veya daha fazla belirtilen veri biçimiyle birlikte bu veri nesnesinde depolar. Bu aşırı yükleme, verilerin alınırken başka bir biçime dönüştürülip dönüştürülemeyeceğini belirten bir Boolean bayrak içerir.

SetData(Type, Object)

Belirtilen verileri bir veya daha fazla belirtilen veri biçimiyle birlikte bu veri nesnesinde depolar; veri biçimi bir Type nesne tarafından belirtilir.

SetFileDropList(StringCollection)

Verileri bu veri nesnesinde depolar FileDrop . Bırakılan dosya listesi dize koleksiyonu olarak belirtilir.

SetImage(BitmapSource)

Verileri bu veri nesnesinde depolar Bitmap . Görüntü verileri olarak BitmapSourcebelirtilir.

SetText(String)

Dize olarak belirtilen verileri bu veri nesnesinde depolar UnicodeText .

SetText(String, TextDataFormat)

Metin verilerini bu veri nesnesinde depolar. Depoacak metin verilerinin biçimi bir üyesiyle TextDataFormatbelirtilir.

ToString()

Geçerli nesneyi temsil eden dizeyi döndürür.

(Devralındığı yer: Object)

İliştirilmiş Olaylar

Copying

İlişkili bağımlılık nesnesi kopyalama seçimini temsil eden uygun veri biçimlerini hazırladığında, kopyalama seçimi biçimlerini bir DataObjectöğesine eklediğinde ve öğesini üzerine Clipboard yerleştirmeye DataObject veya sürükleyip bırakma işlemine başlamaya hazır olduğunda gerçekleşir.

Pasting

İlişkili bağımlılık nesnesi verileri yapıştırmaya hazır olduğunda gerçekleşir.

SettingData

İlişkili bağımlılık nesnesi öğesine yeni bir veri biçimi DataObjecteklemeyi denediğinde gerçekleşir.

Belirtik Arabirim Kullanımları

IDataObject.DAdvise(FORMATETC, ADVF, IAdviseSink, Int32)

Veri nesnesi ile danışmanlık havuzu arasında bir bağlantı oluşturur. Bu yöntem, bir danışmanlık havuzu destekleyen bir nesne tarafından çağrılır ve öneri havuzuna nesnenin verilerindeki değişikliklerle ilgili bildirim verilmesini sağlar.

IDataObject.DUnadvise(Int32)

Daha önce oluşturulmuş bir bildirim bağlantısını yok eder.

IDataObject.EnumDAdvise(IEnumSTATDATA)

Geçerli danışmanlık bağlantılarını listelemek için kullanılabilecek bir nesne oluşturur.

IDataObject.EnumFormatEtc(DATADIR)

Bir veri nesnesinin yapılarını listelemek FORMATETC için bir nesne oluşturur. Bu yapılar veya SetData(FORMATETC, STGMEDIUM, Boolean)çağrılarında GetData(FORMATETC, STGMEDIUM) kullanılır.

IDataObject.GetCanonicalFormatEtc(FORMATETC, FORMATETC)

Mantıksal olarak daha karmaşık bir yapıya eşdeğer standart FORMATETC bir yapı sağlar. Yinelenen işleme gereksinimini ortadan kaldırarak iki farklı FORMATETC yapının aynı verileri döndürip döndürmeyeceğini belirlemek için bu yöntemi kullanın.

IDataObject.GetData(FORMATETC, STGMEDIUM)

Bir kaynak veri nesnesinden veri alır. Bir GetData(FORMATETC, STGMEDIUM) veri tüketicisi tarafından çağrılan yöntemi, belirtilen yapıda açıklanan verileri işler ve belirtilen FORMATETCSTGMEDIUM yapı üzerinden aktarır. Ardından çağıran, yapıyı STGMEDIUM serbest bırakma sorumluluğunu üstlenir.

IDataObject.GetDataHere(FORMATETC, STGMEDIUM)

Bir kaynak veri nesnesinden veri alır. Bir veri tüketicisi tarafından çağrılan bu yöntem, çağıranın belirtilen depolama medyasını GetData(FORMATETC, STGMEDIUM) ayırması ve boşaltması gereken yönteminden farklıdır.

IDataObject.QueryGetData(FORMATETC)

Veri nesnesinin yapıda FORMATETC açıklanan verileri işleyip işleyemeyeceğini belirler. Yapıştırma veya bırakma işlemine çalışan nesneler, işlemin başarılı olup olmadığının bir göstergesini almak için çağırmadan GetData(FORMATETC, STGMEDIUM) önce bu yöntemi çağırabilir.

IDataObject.SetData(FORMATETC, STGMEDIUM, Boolean)

Bu yöntemi uygulayan nesneye veri aktarır. Bu yöntem, veri kaynağı içeren bir nesne tarafından çağrılır.

Şunlara uygulanır

Ayrıca bkz.