DataObject Klass

Definition

Tillhandahåller en grundläggande implementering av gränssnittet, som definierar en formatoberoende mekanism för överföring av IDataObject data.

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

Exempel

I följande exempel visas hur du använder den här klassen.

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)

Kommentarer

Important

Att anropa metoder från den här klassen med ej betrodda data är en säkerhetsrisk. Anropa metoderna från den här klassen endast med betrodda data. För mer information, se Verifiera alla indata.

Konstruktorer

Name Description
DataObject()

Initierar en ny instans av DataObject klassen.

DataObject(Object)

Initierar en ny instans av DataObject klassen som innehåller angivna data.

DataObject(String, Object, Boolean)

Initierar en ny instans av DataObject klassen som innehåller angivna data och dess associerade format. Formatet anges av en sträng. Den här överlagringen innehåller en Boolean flagga som anger om data kan konverteras till ett annat format vid hämtning.

DataObject(String, Object)

Initierar en ny instans av DataObject klassen som innehåller angivna data och dess associerade format. Formatet anges av en sträng.

DataObject(Type, Object)

Initierar en ny instans av DataObject klassen som innehåller angivna data och dess associerade format. Dataformatet anges av ett Type objekt.

Fält

Name Description
CopyingEvent

Identifierar den Copying kopplade händelsen.

PastingEvent

Identifierar den Pasting kopplade händelsen.

SettingDataEvent

Identifierar den SettingData kopplade händelsen.

Metoder

Name Description
AddCopyingHandler(DependencyObject, DataObjectCopyingEventHandler)

Lägger till en Copying händelsehanterare i ett angivet beroendeobjekt.

AddPastingHandler(DependencyObject, DataObjectPastingEventHandler)

Lägger till en Pasting händelsehanterare i ett angivet beroendeobjekt.

AddSettingDataHandler(DependencyObject, DataObjectSettingDataEventHandler)

Lägger till en SettingData händelsehanterare i ett angivet beroendeobjekt.

ContainsAudio()

Frågar ett dataobjekt om det finns data i dataformatet WaveAudio .

ContainsFileDropList()

Frågar ett dataobjekt om det finns data i dataformatet FileDrop .

ContainsImage()

Frågar ett dataobjekt om det finns data i dataformatet Bitmap .

ContainsText()

Frågar ett dataobjekt om det finns data i UnicodeText formatet.

ContainsText(TextDataFormat)

Frågar ett dataobjekt om det finns data i ett textdataformat.

Equals(Object)

Avgör om det angivna objektet är lika med det aktuella objektet.

(Ärvd från Object)
GetAudioStream()

Returnerar en dataström som innehåller data i WaveAudio dataformatet.

GetData(String, Boolean)

Returnerar ett dataobjekt i ett angivet format, om du vill konvertera data till det angivna formatet.

GetData(String)

Returnerar data i ett format som anges av en sträng.

GetData(Type)

Returnerar ett dataobjekt i ett format som anges av ett Type objekt.

GetDataPresent(String, Boolean)

Avgör om data är tillgängliga i, eller kan konverteras till, ett angivet format. En Boolean flagga anger om du vill kontrollera om data kan konverteras till det angivna formatet om de inte är tillgängliga i det formatet.

GetDataPresent(String)

Avgör om data är tillgängliga i, eller kan konverteras till, ett format som anges av en sträng.

GetDataPresent(Type)

Avgör om data är tillgängliga i, eller kan konverteras till, ett format som anges av ett Type objekt.

GetFileDropList()

Returnerar en strängsamling som innehåller en lista över borttagna filer.

GetFormats()

Returnerar en lista med format där data i det här dataobjektet lagras eller kan konverteras till.

GetFormats(Boolean)

Returnerar en lista över format där data i det här dataobjektet lagras. En Boolean flagga anger om du även ska inkludera format som data kan konverteras automatiskt till.

GetHashCode()

Fungerar som standard-hash-funktion.

(Ärvd från Object)
GetImage()

Returnerar ett BitmapSource objekt som innehåller data i Bitmap formatet.

GetText()

Returnerar en sträng som innehåller UnicodeText data i det här dataobjektet.

GetText(TextDataFormat)

Returnerar en sträng som innehåller textdata i det angivna formatet i det här dataobjektet.

GetType()

Hämtar den aktuella instansen Type .

(Ärvd från Object)
MemberwiseClone()

Skapar en ytlig kopia av den aktuella Object.

(Ärvd från Object)
RemoveCopyingHandler(DependencyObject, DataObjectCopyingEventHandler)

Tar bort en Copying händelsehanterare från ett angivet beroendeobjekt.

RemovePastingHandler(DependencyObject, DataObjectPastingEventHandler)

Tar bort en Pasting händelsehanterare från ett angivet beroendeobjekt.

RemoveSettingDataHandler(DependencyObject, DataObjectSettingDataEventHandler)

Tar bort en SettingData händelsehanterare från ett angivet beroendeobjekt.

SetAudio(Byte[])

Lagrar ljuddata (WaveAudio dataformat) i det här dataobjektet. Ljuddata anges som en bytematris.

SetAudio(Stream)

Lagrar ljuddata (WaveAudio dataformat) i det här dataobjektet. Ljuddata anges som en ström.

SetData(Object)

Lagrar angivna data i det här dataobjektet och bestämmer automatiskt dataformatet från källobjekttypen.

SetData(String, Object, Boolean)

Lagrar angivna data i det här dataobjektet, tillsammans med ett eller flera angivna dataformat. Den här överlagringen innehåller en Boolean flagga som anger om data kan konverteras till ett annat format vid hämtning.

SetData(String, Object)

Lagrar angivna data i det här dataobjektet, tillsammans med ett eller flera angivna dataformat. dataformatet anges av en sträng.

SetData(Type, Object)

Lagrar angivna data i det här dataobjektet, tillsammans med ett eller flera angivna dataformat. dataformatet anges av ett Type objekt.

SetDataAsJson<T>(String, T)

Tillhandahåller en grundläggande implementering av gränssnittet, som definierar en formatoberoende mekanism för överföring av IDataObject data.

SetDataAsJson<T>(T)

Tillhandahåller en grundläggande implementering av gränssnittet, som definierar en formatoberoende mekanism för överföring av IDataObject data.

SetFileDropList(StringCollection)

Lagrar FileDrop data i det här dataobjektet. Den borttagna fillistan anges som en strängsamling.

SetImage(BitmapSource)

Lagrar Bitmap data i det här dataobjektet. Bilddata anges som en BitmapSource.

SetText(String, TextDataFormat)

Lagrar textdata i det här dataobjektet. Formatet för textdata som ska lagras anges med en medlem i TextDataFormat.

SetText(String)

Lagrar UnicodeText data, som anges som en sträng, i det här dataobjektet.

ToString()

Returnerar en sträng som representerar det aktuella objektet.

(Ärvd från Object)
TryGetData<T>(String, Boolean, T)

Tillhandahåller en grundläggande implementering av gränssnittet, som definierar en formatoberoende mekanism för överföring av IDataObject data.

TryGetData<T>(String, Func<TypeName,Type>, Boolean, T)

Tillhandahåller en grundläggande implementering av gränssnittet, som definierar en formatoberoende mekanism för överföring av IDataObject data.

TryGetData<T>(String, T)

Tillhandahåller en grundläggande implementering av gränssnittet, som definierar en formatoberoende mekanism för överföring av IDataObject data.

TryGetData<T>(T)

Tillhandahåller en grundläggande implementering av gränssnittet, som definierar en formatoberoende mekanism för överföring av IDataObject data.

Anslutna händelser

Name Description
Copying

Inträffar när det associerade beroendeobjektet har förberett lämpliga dataformat som representerar kopieringsmarkeringen, lagt till kopieringsmarkeringsformaten till en DataObject, och är redo att antingen placera DataObjectClipboard eller starta en dra och släpp-åtgärd.

Pasting

Inträffar när det associerade beroendeobjektet är redo att klistra in data.

SettingData

Inträffar när det associerade beroendeobjektet försöker lägga till ett nytt dataformat i en DataObject.

Explicita gränssnittsimplementeringar

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

Skapar en anslutning mellan ett dataobjekt och en rådgivande mottagare. Den här metoden anropas av ett objekt som stöder en rådgivande mottagare och gör att den rådgivande mottagaren kan meddelas om ändringar i objektets data.

IDataObject.DUnadvise(Int32)

Förstör en meddelandeanslutning som tidigare upprättats.

IDataObject.EnumDAdvise(IEnumSTATDATA)

Skapar ett objekt som kan användas för att räkna upp de aktuella rådgivande anslutningarna.

IDataObject.EnumFormatEtc(DATADIR)

Skapar ett objekt för att räkna upp strukturerna FORMATETC för ett dataobjekt. Dessa strukturer används i anrop till GetData(FORMATETC, STGMEDIUM) eller SetData(FORMATETC, STGMEDIUM, Boolean).

IDataObject.GetCanonicalFormatEtc(FORMATETC, FORMATETC)

Tillhandahåller en standardstruktur FORMATETC som logiskt motsvarar en mer komplex struktur. Använd den här metoden för att avgöra om två olika FORMATETC strukturer skulle returnera samma data, vilket tar bort behovet av duplicerad återgivning.

IDataObject.GetData(FORMATETC, STGMEDIUM)

Hämtar data från ett källdataobjekt. Metoden GetData(FORMATETC, STGMEDIUM) , som anropas av en datakonsument, återger de data som beskrivs i den angivna FORMATETC strukturen och överför dem via den angivna STGMEDIUM strukturen. Anroparen tar sedan ansvar för att STGMEDIUM frigöra strukturen.

IDataObject.GetDataHere(FORMATETC, STGMEDIUM)

Hämtar data från ett källdataobjekt. Den här metoden, som anropas av en datakonsument, skiljer sig från metoden GetData(FORMATETC, STGMEDIUM) eftersom anroparen måste allokera och frigöra det angivna lagringsmediet.

IDataObject.QueryGetData(FORMATETC)

Avgör om dataobjektet kan återge de data som beskrivs i FORMATETC strukturen. Objekt som försöker klistra in eller släppa kan anropa den här metoden innan de anropas GetData(FORMATETC, STGMEDIUM) för att få en indikation på om åtgärden kan lyckas.

IDataObject.SetData(FORMATETC, STGMEDIUM, Boolean)

Överför data till objektet som implementerar den här metoden. Den här metoden anropas av ett objekt som innehåller en datakälla.

Tilläggsmetoder

Name Description
TryGetData<T>(IDataObject, String, Boolean, T)

Tillhandahåller en grundläggande implementering av gränssnittet, som definierar en formatoberoende mekanism för överföring av IDataObject data.

TryGetData<T>(IDataObject, String, Func<TypeName,Type>, Boolean, T)

Tillhandahåller en grundläggande implementering av gränssnittet, som definierar en formatoberoende mekanism för överföring av IDataObject data.

TryGetData<T>(IDataObject, String, T)

Tillhandahåller en grundläggande implementering av gränssnittet, som definierar en formatoberoende mekanism för överföring av IDataObject data.

TryGetData<T>(IDataObject, T)

Tillhandahåller en grundläggande implementering av gränssnittet, som definierar en formatoberoende mekanism för överföring av IDataObject data.

Gäller för

Se även