DataObject Klas

Definitie

Naamruimte:
System.Windows
Assembly:
PresentationCore.dll

Biedt een eenvoudige implementatie van de IDataObject interface, die een indelingsonafhankelijk mechanisme definieert voor het overdragen van gegevens.

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
Overname
Object
DataObject
Implementeringen
IDataObject IDataObject

Voorbeelden

In het volgende voorbeeld ziet u hoe u deze klasse gebruikt.

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)

Opmerkingen

Important

Het aanroepen van methoden uit deze klasse met niet-vertrouwde gegevens is een beveiligingsrisico. Roep de methoden van deze klasse alleen aan met vertrouwde gegevens. Zie Alle invoergegevens validerenvoor meer informatie.

Constructors

Name Description
DataObject()

Initialiseert een nieuw exemplaar van de DataObject klasse.
DataObject(Object)

Initialiseert een nieuw exemplaar van de DataObject klasse die de opgegeven gegevens bevat.
DataObject(String, Object, Boolean)

Initialiseert een nieuw exemplaar van de DataObject klasse die de opgegeven gegevens en de bijbehorende indeling bevat. De indeling wordt opgegeven door een tekenreeks. Deze overbelasting bevat een Boolean vlag om aan te geven of de gegevens kunnen worden geconverteerd naar een andere indeling bij het ophalen.
DataObject(String, Object)

Initialiseert een nieuw exemplaar van de DataObject klasse die de opgegeven gegevens en de bijbehorende indeling bevat. De indeling wordt opgegeven door een tekenreeks.
DataObject(Type, Object)

Initialiseert een nieuw exemplaar van de DataObject klasse die de opgegeven gegevens en de bijbehorende indeling bevat. De gegevensindeling wordt opgegeven door een Type object.

Velden

Name Description
CopyingEvent

Identificeert de Copying gekoppelde gebeurtenis.
PastingEvent

Identificeert de Pasting gekoppelde gebeurtenis.
SettingDataEvent

Identificeert de SettingData gekoppelde gebeurtenis.

Methoden

Name Description
AddCopyingHandler(DependencyObject, DataObjectCopyingEventHandler)

Hiermee voegt u een Copying gebeurtenis-handler toe aan een opgegeven afhankelijkheidsobject.
AddPastingHandler(DependencyObject, DataObjectPastingEventHandler)

Hiermee voegt u een Pasting gebeurtenis-handler toe aan een opgegeven afhankelijkheidsobject.
AddSettingDataHandler(DependencyObject, DataObjectSettingDataEventHandler)

Hiermee voegt u een SettingData gebeurtenis-handler toe aan een opgegeven afhankelijkheidsobject.
ContainsAudio()

Hiermee wordt een query uitgevoerd op een gegevensobject voor de aanwezigheid van gegevens in de WaveAudio gegevensindeling.
ContainsFileDropList()

Hiermee wordt een query uitgevoerd op een gegevensobject voor de aanwezigheid van gegevens in de FileDrop gegevensindeling.
ContainsImage()

Hiermee wordt een query uitgevoerd op een gegevensobject voor de aanwezigheid van gegevens in de Bitmap gegevensindeling.
ContainsText()

Hiermee wordt een query uitgevoerd op een gegevensobject voor de aanwezigheid van gegevens in de UnicodeText indeling.
ContainsText(TextDataFormat)

Query's uitvoeren op een gegevensobject voor de aanwezigheid van gegevens in een tekstgegevensindeling.
Equals(Object)

Bepaalt of het opgegeven object gelijk is aan het huidige object.

(Overgenomen van Object)
GetAudioStream()

Retourneert een stroom die gegevens in de WaveAudio gegevensindeling bevat.
GetData(String, Boolean)

Retourneert een gegevensobject in een opgegeven indeling, optioneel het converteren van de gegevens naar de opgegeven indeling.
GetData(String)

Retourneert gegevens in een indeling die is opgegeven door een tekenreeks.
GetData(Type)

Retourneert een gegevensobject in een indeling die is opgegeven door een Type object.
GetDataPresent(String, Boolean)

Bepaalt of de gegevens beschikbaar zijn in of kunnen worden geconverteerd naar een opgegeven indeling. Een Boolean vlag geeft aan of de gegevens kunnen worden geconverteerd naar de opgegeven indeling als deze niet beschikbaar zijn in die indeling.
GetDataPresent(String)

Bepaalt of de gegevens beschikbaar zijn in of kunnen worden geconverteerd naar een indeling die is opgegeven door een tekenreeks.
GetDataPresent(Type)

Bepaalt of de gegevens beschikbaar zijn in of kunnen worden geconverteerd naar een indeling die is opgegeven door een Type object.
GetFileDropList()

Hiermee wordt een tekenreeksverzameling geretourneerd die een lijst met verwijderde bestanden bevat.
GetFormats()

Retourneert een lijst met indelingen waarin de gegevens in dit gegevensobject worden opgeslagen of waarnaar kan worden geconverteerd.
GetFormats(Boolean)

Retourneert een lijst met indelingen waarin de gegevens in dit gegevensobject worden opgeslagen. Een Boolean vlag geeft aan of de gegevens ook indelingen moeten bevatten waarnaar de gegevens automatisch kunnen worden geconverteerd.
GetHashCode()

Fungeert als de standaardhashfunctie.

(Overgenomen van Object)
GetImage()

Retourneert een BitmapSource object dat gegevens in de Bitmap indeling bevat.
GetText()

Retourneert een tekenreeks die de UnicodeText gegevens in dit gegevensobject bevat.
GetText(TextDataFormat)

Retourneert een tekenreeks die tekstgegevens van de opgegeven indeling in dit gegevensobject bevat.
GetType()

Hiermee haalt u de Type huidige instantie op.

(Overgenomen van Object)
MemberwiseClone()

Hiermee maakt u een ondiepe kopie van de huidige Object.

(Overgenomen van Object)
RemoveCopyingHandler(DependencyObject, DataObjectCopyingEventHandler)

Hiermee verwijdert u een Copying gebeurtenis-handler uit een opgegeven afhankelijkheidsobject.
RemovePastingHandler(DependencyObject, DataObjectPastingEventHandler)

Hiermee verwijdert u een Pasting gebeurtenis-handler uit een opgegeven afhankelijkheidsobject.
RemoveSettingDataHandler(DependencyObject, DataObjectSettingDataEventHandler)

Hiermee verwijdert u een SettingData gebeurtenis-handler uit een opgegeven afhankelijkheidsobject.
SetAudio(Byte[])

Slaat audiogegevens (WaveAudio gegevensindeling) op in dit gegevensobject. De audiogegevens worden opgegeven als een bytematrix.
SetAudio(Stream)

Slaat audiogegevens (WaveAudio gegevensindeling) op in dit gegevensobject. De audiogegevens worden opgegeven als een stream.
SetData(Object)

Slaat de opgegeven gegevens in dit gegevensobject op en bepaalt automatisch de gegevensindeling van het bronobjecttype.
SetData(String, Object, Boolean)

Slaat de opgegeven gegevens op in dit gegevensobject, samen met een of meer opgegeven gegevensindelingen. Deze overbelasting bevat een Boolean vlag om aan te geven of de gegevens kunnen worden geconverteerd naar een andere indeling bij het ophalen.
SetData(String, Object)

Slaat de opgegeven gegevens op in dit gegevensobject, samen met een of meer opgegeven gegevensindelingen; de gegevensindeling wordt opgegeven door een tekenreeks.
SetData(Type, Object)

Slaat de opgegeven gegevens op in dit gegevensobject, samen met een of meer opgegeven gegevensindelingen; de gegevensindeling wordt opgegeven door een Type object.
SetFileDropList(StringCollection)

Slaat FileDrop gegevens op in dit gegevensobject. De lijst met verwijderde bestanden wordt opgegeven als een tekenreeksverzameling.
SetImage(BitmapSource)

Slaat Bitmap gegevens op in dit gegevensobject. De afbeeldingsgegevens worden opgegeven als een BitmapSource.
SetText(String, TextDataFormat)

Slaat tekstgegevens op in dit gegevensobject. De indeling van de tekstgegevens die moeten worden opgeslagen, wordt opgegeven met een lid van TextDataFormat.
SetText(String)

Slaat UnicodeText gegevens op, opgegeven als een tekenreeks, in dit gegevensobject.
ToString()

Retourneert een tekenreeks die het huidige object vertegenwoordigt.

(Overgenomen van Object)

Toegevoegde gebeurtenissen

Name Description
Copying

Treedt op wanneer het gekoppelde afhankelijkheidsobject de juiste gegevensindelingen heeft voorbereid die de kopieerselectie vertegenwoordigen, de opmaak van de kopieerselectie heeft toegevoegd aan een DataObjecten klaar is om de DataObject bewerking te Clipboard plaatsen of te beginnen met slepen en neerzetten.
Pasting

Treedt op wanneer het gekoppelde afhankelijkheidsobject gereed is om gegevens te plakken.
SettingData

Treedt op wanneer het gekoppelde afhankelijkheidsobject probeert een nieuwe gegevensindeling toe te voegen aan een DataObject.

Expliciete interface-implementaties

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

Hiermee maakt u een verbinding tussen een gegevensobject en een adviessink. Deze methode wordt aangeroepen door een object dat ondersteuning biedt voor een adviessink en stelt de adviessink in staat om op de hoogte te worden gesteld van wijzigingen in de gegevens van het object.
IDataObject.DUnadvise(Int32)

Hiermee wordt een meldingsverbinding vernietigd die eerder tot stand was gebracht.
IDataObject.EnumDAdvise(IEnumSTATDATA)

Hiermee maakt u een object dat kan worden gebruikt om de huidige adviesverbindingen op te sommen.
IDataObject.EnumFormatEtc(DATADIR)

Hiermee maakt u een object voor het inventariseren van de FORMATETC structuren voor een gegevensobject. Deze structuren worden gebruikt in aanroepen naar GetData(FORMATETC, STGMEDIUM) of SetData(FORMATETC, STGMEDIUM, Boolean).
IDataObject.GetCanonicalFormatEtc(FORMATETC, FORMATETC)

Biedt een standaardstructuur FORMATETC die logisch gelijk is aan een complexere structuur. Gebruik deze methode om te bepalen of twee verschillende FORMATETC structuren dezelfde gegevens retourneren, waardoor dubbele rendering niet meer nodig is.
IDataObject.GetData(FORMATETC, STGMEDIUM)

Hiermee worden gegevens opgehaald uit een brongegevensobject. De GetData(FORMATETC, STGMEDIUM) methode, die wordt aangeroepen door een gegevensgebruiker, geeft de gegevens weer die worden beschreven in de opgegeven FORMATETC structuur en draagt deze over via de opgegeven STGMEDIUM structuur. De beller neemt vervolgens de verantwoordelijkheid voor het vrijgeven van de STGMEDIUM structuur.
IDataObject.GetDataHere(FORMATETC, STGMEDIUM)

Hiermee worden gegevens opgehaald uit een brongegevensobject. Deze methode, die wordt aangeroepen door een gegevensgebruiker, verschilt van de GetData(FORMATETC, STGMEDIUM) methode waarin de aanroeper het opgegeven opslagmedium moet toewijzen en vrijmaken.
IDataObject.QueryGetData(FORMATETC)

Bepaalt of het gegevensobject de gegevens kan weergeven die in de FORMATETC structuur worden beschreven. Objecten die een bewerking voor plakken of neerzetten proberen, kunnen deze methode aanroepen GetData(FORMATETC, STGMEDIUM) voordat u een indicatie krijgt of de bewerking kan slagen.
IDataObject.SetData(FORMATETC, STGMEDIUM, Boolean)

Hiermee worden gegevens overgedragen naar het object dat deze methode implementeert. Deze methode wordt aangeroepen door een object dat een gegevensbron bevat.

Van toepassing op

Zie ook