DataObject Klasa

Definicja

Przestrzeń nazw:: System.Windows

Zestaw:: PresentationCore.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Zapewnia podstawową implementację interfejsu IDataObject , która definiuje niezależny od formatu mechanizm przesyłania danych.

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

Dziedziczenie: Object
DataObject

Implementuje: IDataObject IDataObject ITypedDataObject

Przykłady

W poniższym przykładzie pokazano, jak używać tej klasy.

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)

Uwagi

Important

Wywoływanie metod z tej klasy z niezaufanymi danymi jest zagrożeniem bezpieczeństwa. Wywołaj metody z tej klasy tylko z zaufanymi danymi. Aby uzyskać więcej informacji, zobacz Validate All Inputs.

Konstruktory

Nazwa	Opis
DataObject()	Inicjuje nowe wystąpienie klasy DataObject.
DataObject(Object)	Inicjuje DataObject nowe wystąpienie klasy zawierającej określone dane.
DataObject(String, Object, Boolean)	Inicjuje nowe wystąpienie DataObject klasy zawierającej określone dane i skojarzony z nim format; format jest określany przez ciąg. To przeciążenie zawiera flagę wskazującą `Boolean` , czy dane mogą być konwertowane na inny format podczas pobierania.
DataObject(String, Object)	Inicjuje nowe wystąpienie DataObject klasy zawierającej określone dane i skojarzony z nim format; format jest określany przez ciąg.
DataObject(Type, Object)	Inicjuje nowe wystąpienie DataObject klasy zawierające określone dane i skojarzony format; format danych jest określany przez Type obiekt.

Pola

Nazwa	Opis
CopyingEvent	Copying Identyfikuje dołączone zdarzenie.
PastingEvent	Pasting Identyfikuje dołączone zdarzenie.
SettingDataEvent	SettingData Identyfikuje dołączone zdarzenie.

Metody

Nazwa	Opis
AddCopyingHandler(DependencyObject, DataObjectCopyingEventHandler)	Dodaje procedurę obsługi zdarzeń Copying do określonego obiektu zależności.
AddPastingHandler(DependencyObject, DataObjectPastingEventHandler)	Dodaje procedurę obsługi zdarzeń Pasting do określonego obiektu zależności.
AddSettingDataHandler(DependencyObject, DataObjectSettingDataEventHandler)	Dodaje procedurę obsługi zdarzeń SettingData do określonego obiektu zależności.
ContainsAudio()	Wysyła zapytanie do obiektu danych pod kątem obecności danych w WaveAudio formacie danych.
ContainsFileDropList()	Wysyła zapytanie do obiektu danych pod kątem obecności danych w FileDrop formacie danych.
ContainsImage()	Wysyła zapytanie do obiektu danych pod kątem obecności danych w Bitmap formacie danych.
ContainsText()	Wysyła zapytanie do obiektu danych pod kątem obecności danych w UnicodeText formacie.
ContainsText(TextDataFormat)	Odpytuje obiekt danych pod kątem obecności danych w formacie danych tekstowych.
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetAudioStream()	Zwraca strumień zawierający dane w WaveAudio formacie danych.
GetData(String, Boolean)	Zwraca obiekt danych w określonym formacie, opcjonalnie konwertując dane na określony format.
GetData(String)	Zwraca dane w formacie określonym przez ciąg.
GetData(Type)	Zwraca obiekt danych w formacie określonym przez Type obiekt.
GetDataPresent(String, Boolean)	Określa, czy dane są dostępne w określonym formacie, czy też można je przekonwertować. Flaga `Boolean` wskazuje, czy dane można przekonwertować na określony format, jeśli nie są dostępne w tym formacie.
GetDataPresent(String)	Określa, czy dane są dostępne w pliku lub można je przekonwertować na format określony przez ciąg.
GetDataPresent(Type)	Określa, czy dane są dostępne w obiekcie, czy też mogą być konwertowane na format określony przez Type obiekt.
GetFileDropList()	Zwraca kolekcję ciągów zawierającą listę porzuconych plików.
GetFormats()	Zwraca listę formatów, w których dane w tym obiekcie danych są przechowywane lub mogą być konwertowane na.
GetFormats(Boolean)	Zwraca listę formatów, w których są przechowywane dane w tym obiekcie danych. Flaga `Boolean` wskazuje, czy należy również uwzględnić formaty, na które można automatycznie konwertować dane.
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetImage()	BitmapSource Zwraca obiekt, który zawiera dane w Bitmap formacie.
GetText()	Zwraca ciąg zawierający UnicodeText dane w tym obiekcie danych.
GetText(TextDataFormat)	Zwraca ciąg zawierający dane tekstowe określonego formatu w tym obiekcie danych.
GetType()	Pobiera Type bieżącego wystąpienia. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Object. (Odziedziczone po Object)
RemoveCopyingHandler(DependencyObject, DataObjectCopyingEventHandler)	Copying Usuwa program obsługi zdarzeń z określonego obiektu zależności.
RemovePastingHandler(DependencyObject, DataObjectPastingEventHandler)	Pasting Usuwa program obsługi zdarzeń z określonego obiektu zależności.
RemoveSettingDataHandler(DependencyObject, DataObjectSettingDataEventHandler)	SettingData Usuwa program obsługi zdarzeń z określonego obiektu zależności.
SetAudio(Byte[])	Przechowuje dane audio (WaveAudio format danych) w tym obiekcie danych. Dane audio są określane jako tablica bajtów.
SetAudio(Stream)	Przechowuje dane audio (WaveAudio format danych) w tym obiekcie danych. Dane audio są określane jako strumień.
SetData(Object)	Przechowuje określone dane w tym obiekcie danych, automatycznie określając format danych z typu obiektu źródłowego.
SetData(String, Object, Boolean)	Przechowuje określone dane w tym obiekcie danych wraz z co najmniej jednym określonym formatem danych. To przeciążenie zawiera flagę wskazującą `Boolean` , czy dane można przekonwertować na inny format podczas pobierania.
SetData(String, Object)	Przechowuje określone dane w tym obiekcie danych wraz z co najmniej jednym określonym formatem danych; format danych jest określany przez ciąg.
SetData(Type, Object)	Przechowuje określone dane w tym obiekcie danych wraz z co najmniej jednym określonym formatem danych; format danych jest określany przez Type obiekt.
SetDataAsJson<T>(String, T)	Zapewnia podstawową implementację interfejsu IDataObject , która definiuje niezależny od formatu mechanizm przesyłania danych.
SetDataAsJson<T>(T)	Zapewnia podstawową implementację interfejsu IDataObject , która definiuje niezależny od formatu mechanizm przesyłania danych.
SetFileDropList(StringCollection)	Przechowuje FileDrop dane w tym obiekcie danych. Porzucona lista plików jest określana jako kolekcja ciągów.
SetImage(BitmapSource)	Przechowuje Bitmap dane w tym obiekcie danych. Dane obrazu są określane jako BitmapSource.
SetText(String, TextDataFormat)	Przechowuje dane tekstowe w tym obiekcie danych. Format danych tekstowych do przechowywania jest określony z elementem członkowskim TextDataFormat.
SetText(String)	UnicodeText Przechowuje dane określone jako ciąg w tym obiekcie danych.
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)
TryGetData<T>(String, Boolean, T)	Zapewnia podstawową implementację interfejsu IDataObject , która definiuje niezależny od formatu mechanizm przesyłania danych.
TryGetData<T>(String, Func<TypeName,Type>, Boolean, T)	Zapewnia podstawową implementację interfejsu IDataObject , która definiuje niezależny od formatu mechanizm przesyłania danych.
TryGetData<T>(String, T)	Zapewnia podstawową implementację interfejsu IDataObject , która definiuje niezależny od formatu mechanizm przesyłania danych.
TryGetData<T>(T)	Zapewnia podstawową implementację interfejsu IDataObject , która definiuje niezależny od formatu mechanizm przesyłania danych.

Zdarzenia dołączone

Nazwa	Opis
Copying	Występuje, gdy skojarzony obiekt zależności przygotował odpowiednie formaty danych reprezentujące zaznaczenie kopii, dodał formaty wyboru kopiowania do DataObjectobiektu i jest gotowy do umieszczania DataObject obiektu na Clipboard lub rozpoczęcia operacji przeciągania i upuszczania.
Pasting	Występuje, gdy skojarzony obiekt zależności jest gotowy do wklejania danych.
SettingData	Występuje, gdy skojarzony obiekt zależności próbuje dodać nowy format danych do obiektu DataObject.

Jawne implementacje interfejsu

Nazwa	Opis
IDataObject.DAdvise(FORMATETC, ADVF, IAdviseSink, Int32)	Tworzy połączenie między obiektem danych a ujściem porady. Ta metoda jest wywoływana przez obiekt, który obsługuje ujście porady i umożliwia ujście porady powiadamianie o zmianach w danych obiektu.
IDataObject.DUnadvise(Int32)	Niszczy połączenie powiadomień, które zostało wcześniej ustanowione.
IDataObject.EnumDAdvise(IEnumSTATDATA)	Tworzy obiekt, który może służyć do wyliczania bieżących połączeń doradczych.
IDataObject.EnumFormatEtc(DATADIR)	Tworzy obiekt do wyliczania FORMATETC struktur dla obiektu danych. Te struktury są używane w wywołaniach do GetData(FORMATETC, STGMEDIUM) lub SetData(FORMATETC, STGMEDIUM, Boolean).
IDataObject.GetCanonicalFormatEtc(FORMATETC, FORMATETC)	Zapewnia standardową FORMATETC strukturę, która jest logicznie równoważna bardziej złożonej strukturze. Użyj tej metody, aby określić, czy dwie różne FORMATETC struktury będą zwracać te same dane, usuwając potrzebę renderowania zduplikowanego.
IDataObject.GetData(FORMATETC, STGMEDIUM)	Uzyskuje dane z obiektu danych źródłowych. Metoda GetData(FORMATETC, STGMEDIUM) , która jest wywoływana przez odbiorcę danych, renderuje dane opisane w określonej strukturze i przesyła je za pośrednictwem określonej FORMATETC STGMEDIUM struktury. Następnie wywołujący przejmuje odpowiedzialność za uwolnienie STGMEDIUM struktury.
IDataObject.GetDataHere(FORMATETC, STGMEDIUM)	Uzyskuje dane z obiektu danych źródłowych. Ta metoda, wywoływana przez użytkownika danych, różni się od GetData(FORMATETC, STGMEDIUM) metody, w której obiekt wywołujący musi przydzielić i zwolnić określony nośnik magazynu.
IDataObject.QueryGetData(FORMATETC)	Określa, czy obiekt danych może renderować dane opisane w FORMATETC strukturze. Obiekty próbujące wykonać operację wklejania lub upuszczania mogą wywołać tę metodę przed wywołaniem GetData(FORMATETC, STGMEDIUM) metody w celu uzyskania wskazania, czy operacja może zakończyć się pomyślnie.
IDataObject.SetData(FORMATETC, STGMEDIUM, Boolean)	Transferuje dane do obiektu, który implementuje tę metodę. Ta metoda jest wywoływana przez obiekt, który zawiera źródło danych.

Metody rozszerzania

Nazwa	Opis
TryGetData<T>(IDataObject, String, Boolean, T)	Zapewnia podstawową implementację interfejsu IDataObject , która definiuje niezależny od formatu mechanizm przesyłania danych.
TryGetData<T>(IDataObject, String, Func<TypeName,Type>, Boolean, T)	Zapewnia podstawową implementację interfejsu IDataObject , która definiuje niezależny od formatu mechanizm przesyłania danych.
TryGetData<T>(IDataObject, String, T)	Zapewnia podstawową implementację interfejsu IDataObject , która definiuje niezależny od formatu mechanizm przesyłania danych.
TryGetData<T>(IDataObject, T)	Zapewnia podstawową implementację interfejsu IDataObject , która definiuje niezależny od formatu mechanizm przesyłania danych.

Dotyczy

Zobacz też

Ładowanie usuniętego przykładu pliku

Opinia

Czy ta strona była pomocna?