DataObject Klasa

Odwołanie

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 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

Dziedziczenie: Object
DataObject

Implementuje: IDataObject IDataObject

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

Ważne

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 Weryfikowanie wszystkich danych wejściowych.

Konstruktory

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

Pola

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

Metody

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()	Wykonuje zapytania dotyczące obiektu danych pod kątem WaveAudio obecności danych w formacie danych.
ContainsFileDropList()	Wykonuje zapytania dotyczące obiektu danych pod kątem FileDrop obecności danych w formacie danych.
ContainsImage()	Wykonuje zapytania dotyczące obiektu danych pod kątem Bitmap obecności danych w formacie danych.
ContainsText()	Wykonuje zapytania dotyczące obiektu danych pod kątem obecności danych w UnicodeText formacie.
ContainsText(TextDataFormat)	Wykonuje zapytania dotyczące obiektu 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)	Zwraca dane w formacie określonym przez ciąg.
GetData(String, Boolean)	Zwraca obiekt danych w określonym formacie, opcjonalnie konwertując dane na określony format.
GetData(Type)	Zwraca obiekt danych w formacie określonym przez Type obiekt.
GetDataPresent(String)	Określa, czy dane są dostępne w pliku, czy też można je przekonwertować na format określony przez ciąg.
GetDataPresent(String, Boolean)	Określa, czy dane są dostępne w programie, czy można je przekonwertować na określony format. Flaga `Boolean` wskazuje, czy dane można przekonwertować na określony format, jeśli nie są dostępne w tym formacie.
GetDataPresent(Type)	Określa, czy dane są dostępne, czy 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 zawierający 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()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
RemoveCopyingHandler(DependencyObject, DataObjectCopyingEventHandler)	Usuwa procedurę obsługi zdarzeń Copying z określonego obiektu zależności.
RemovePastingHandler(DependencyObject, DataObjectPastingEventHandler)	Usuwa procedurę obsługi zdarzeń Pasting z określonego obiektu zależności.
RemoveSettingDataHandler(DependencyObject, DataObjectSettingDataEventHandler)	Usuwa procedurę obsługi zdarzeń SettingData 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)	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(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 pobierania.
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.
SetFileDropList(StringCollection)	Przechowuje FileDrop dane w tym obiekcie danych. Lista porzuconych 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)	Przechowuje UnicodeText dane określone jako ciąg w tym obiekcie danych.
SetText(String, TextDataFormat)	Przechowuje dane tekstowe w tym obiekcie danych. Format danych tekstowych do przechowywania jest określony z elementem członkowskim TextDataFormat.
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Zdarzenia dołączone

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 elementu 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

IDataObject.DAdvise(FORMATETC, ADVF, IAdviseSink, Int32)	Tworzy połączenie między obiektem danych a ujściem porad. Ta metoda jest wywoływana przez obiekt, który obsługuje ujście porad i umożliwia ujściu porad powiadomienia o zmianach w danych obiektu.
IDataObject.DUnadvise(Int32)	Niszczy połączenie powiadomień, które zostało wcześniej nawiązane.
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 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 zwracają te same dane, usuwając potrzebę zduplikowanego renderowania.
IDataObject.GetData(FORMATETC, STGMEDIUM)	Uzyskuje dane z obiektu danych źródłowych. Metoda GetData(FORMATETC, STGMEDIUM) , która jest wywoływana przez użytkownika danych, renderuje dane opisane w określonej strukturze i przesyła je przez określoną FORMATETC STGMEDIUM strukturę. Rozmówcy następnie przejmuje odpowiedzialność za uwolnienie STGMEDIUM struktury.
IDataObject.GetDataHere(FORMATETC, STGMEDIUM)	Uzyskuje dane z obiektu danych źródłowych. Ta metoda, która jest 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) aby uzyskać wskazanie, 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 zawierający źródło danych.

Dotyczy

Zobacz też

Ładowanie usuniętego przykładu pliku