DataObject.GetDataPresent Metoda
Definicja
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.
Określa, czy dane przechowywane w tym DataObject formacie są skojarzone z określonym formatem.
Przeciążenia
GetDataPresent(String) |
Określa, czy dane przechowywane w tym DataObject obiekcie są skojarzone z określonym formatem lub można je przekonwertować na. |
GetDataPresent(Type) |
Określa, czy dane przechowywane w tym DataObject obiekcie są skojarzone z określonym formatem lub można je przekonwertować na. |
GetDataPresent(String, Boolean) |
Określa, czy zawiera on DataObject dane w określonym formacie, czy opcjonalnie zawiera dane, które można przekonwertować na określony format. |
GetDataPresent(String)
Określa, czy dane przechowywane w tym DataObject obiekcie są skojarzone z określonym formatem lub można je przekonwertować na.
public:
virtual bool GetDataPresent(System::String ^ format);
public virtual bool GetDataPresent (string format);
abstract member GetDataPresent : string -> bool
override this.GetDataPresent : string -> bool
Public Overridable Function GetDataPresent (format As String) As Boolean
Parametry
- format
- String
Format do sprawdzenia. Zobacz, aby zapoznać się DataFormats ze wstępnie zdefiniowanymi formatami.
Zwraca
true
jeśli dane przechowywane w tym DataObject obiekcie są skojarzone lub mogą być konwertowane na określony format; w przeciwnym razie false
.
Implementuje
Przykłady
Poniższy przykład kodu określa, czy dane przechowywane obecnie w tym DataObject obiekcie są skojarzone z określonym formatem lub można je przekonwertować na określony format. Nowy DataObject jest inicjowany za pomocą ciągu i skojarzonego formatu określonego jako tekst.
Następnie przykłady wyświetlają, czy dane tekstowe istnieją w obiekcie DataObject. Ten kod wymaga textBox1
utworzenia.
Uwagi
Wywołaj tę metodę, aby określić, czy format istnieje przed wywołaniem metody GetData. Wywołaj wywołanie GetFormats formatów dostępnych w tym pliku DataObject.
Uwaga
Dane można przekonwertować na inny format, jeśli były przechowywane, określając, że konwersja jest dozwolona, a żądany format jest zgodny z zapisanym formatem. Na przykład dane przechowywane jako Unicode można przekonwertować na tekst.
Uwaga
Jeśli nie można pobrać żadnych danych, nie zostanie zgłoszony żaden wyjątek.
false
Zamiast tego zostanie zwrócony.
Zobacz też
Dotyczy
GetDataPresent(Type)
Określa, czy dane przechowywane w tym DataObject obiekcie są skojarzone z określonym formatem lub można je przekonwertować na.
public:
virtual bool GetDataPresent(Type ^ format);
public virtual bool GetDataPresent (Type format);
abstract member GetDataPresent : Type -> bool
override this.GetDataPresent : Type -> bool
Public Overridable Function GetDataPresent (format As Type) As Boolean
Parametry
Zwraca
true
jeśli dane przechowywane w tym DataObject obiekcie są skojarzone lub mogą być konwertowane na określony format; w przeciwnym razie false
.
Implementuje
Przykłady
Poniższy przykład kodu określa, czy dane określonego typu istnieją w obiekcie DataObject, czy dane można przekonwertować na określony typ. Wynik jest wyświetlany w polu tekstowym. Kod wymaga textBox1
utworzenia.
private:
void GetIfPresent2()
{
// Creates a component to store in the data object.
Component^ myComponent = gcnew Component;
// Creates a new data object and assigns it the component.
DataObject^ myDataObject = gcnew DataObject( myComponent );
// Creates a type to store the type of data.
Type^ myType = myComponent->GetType();
// Determines if the DataObject has data of the Type format.
textBox1->Text = String::Concat( "Is the specified data type available ",
"in the DataObject? ", myDataObject->GetDataPresent( myType ), "\n" );
// Retrieves the data using its type format, and displays the type.
Object^ myObject = myDataObject->GetData( myType );
textBox1->Text = String::Concat( textBox1->Text, "The data type stored ",
"in the DataObject is: ", myObject->GetType()->Name );
}
private void GetIfPresent2() {
// Creates a component to store in the data object.
Component myComponent = new Component();
// Creates a new data object and assigns it the component.
DataObject myDataObject = new DataObject(myComponent);
// Creates a type to store the type of data.
Type myType = myComponent.GetType();
// Determines if the DataObject has data of the Type format.
textBox1.Text = "Is the specified data type available in the " +
"DataObject? " + myDataObject.GetDataPresent(myType).ToString() + '\n';
// Retrieves the data using its type format, and displays the type.
Object myObject = myDataObject.GetData(myType);
textBox1.Text += "The data type stored in the DataObject is: " +
myObject.GetType().Name;
}
Private Sub GetIfPresent2()
' Creates a component to store in the data object.
Dim myComponent As New Component()
' Creates a new data object and assigns it the component.
Dim myDataObject As New DataObject(myComponent)
' Creates a type to store the type of data.
Dim myType As Type = myComponent.GetType()
' Determines if the DataObject has data of the Type format.
textBox1.Text = "Is the specified data type available in the " & "DataObject? " & _
myDataObject.GetDataPresent(myType).ToString() & ControlChars.Cr
' Retrieves the data using its type format, and displays the type.
Dim myObject As Object = myDataObject.GetData(myType)
textBox1.Text += "The data type stored in the DataObject is: " + myObject.GetType().Name
End Sub
Uwagi
Wywołaj tę metodę, aby określić, czy format istnieje przed wywołaniem metody GetData. Wywołaj wywołanie GetFormats formatów dostępnych w tym pliku DataObject.
Uwaga
Dane można przekonwertować na inny format, jeśli były przechowywane, określając, że konwersja jest dozwolona, a żądany format jest zgodny z zapisanym formatem. Na przykład dane przechowywane jako Unicode można przekonwertować na tekst.
Uwaga
Jeśli nie można pobrać żadnych danych, nie zostanie zgłoszony żaden wyjątek.
false
Zamiast tego zostanie zwrócony.
Zobacz też
Dotyczy
GetDataPresent(String, Boolean)
Określa, czy zawiera on DataObject dane w określonym formacie, czy opcjonalnie zawiera dane, które można przekonwertować na określony format.
public:
virtual bool GetDataPresent(System::String ^ format, bool autoConvert);
public virtual bool GetDataPresent (string format, bool autoConvert);
abstract member GetDataPresent : string * bool -> bool
override this.GetDataPresent : string * bool -> bool
Public Overridable Function GetDataPresent (format As String, autoConvert As Boolean) As Boolean
Parametry
- format
- String
Format do sprawdzenia. Zobacz, aby zapoznać się DataFormats ze wstępnie zdefiniowanymi formatami.
- autoConvert
- Boolean
true
aby określić, czy dane przechowywane w tym DataObject formacie można przekonwertować na określony format, false
aby sprawdzić, czy dane są w określonym formacie.
Zwraca
true
jeśli dane są w obiekcie lub można je przekonwertować na określony format; w przeciwnym razie , false
.
Implementuje
Przykłady
Poniższy przykład kodu określa, czy dane przechowywane obecnie w obiekcie DataObject są skojarzone z określonym formatem. Po pierwsze, nowy DataObject jest inicjowany za pomocą ciągu, określając jego format jako tekst.
DataObject Następnie zapytanie dotyczy danych skojarzonych z formatem tekstu, określając autoConvert
parametr jako false
. Wynik tego zapytania jest drukowany w polu tekstowym.
DataObject Następnie zapytanie dotyczy danych skojarzonych z formatem ciągu, określając autoConvert
parametr jako true
. Wyniki są drukowane w polu tekstowym. Ten kod wymaga textBox1
utworzenia.
private:
void GetIfPresent3()
{
// Creates a new data object using a string and the text format.
DataObject^ myDataObject = gcnew DataObject( DataFormats::Text, "Another string" );
// Prints the string in a text box with autoconvert = false.
if ( myDataObject->GetDataPresent( "System.String", false ) )
{
// Prints the string in a text box.
textBox1->Text = String::Concat(
myDataObject->GetData( "System.String", false )->ToString(), "\n" );
}
else
{
textBox1->Text = "Could not convert data to specified format\n";
}
// Prints the string in a text box with autoconvert = true.
textBox1->Text = String::Concat( textBox1->Text,
"With autoconvert = true, you can convert text to string format. String is: ",
myDataObject->GetData( "System.String", true )->ToString() );
}
private void GetIfPresent3() {
// Creates a new data object using a string and the text format.
DataObject myDataObject = new DataObject(DataFormats.Text, "Another string");
// Prints the string in a text box with autoconvert = false.
if(myDataObject.GetDataPresent("System.String", false)) {
// Prints the string in a text box.
textBox1.Text = myDataObject.GetData("System.String", false).ToString() + '\n';
} else
{
textBox1.Text = "Could not convert data to specified format" + '\n';
}
// Prints the string in a text box with autoconvert = true.
textBox1.Text += "With autoconvert = true, you can convert text to string format. " +
"String is: " + myDataObject.GetData("System.String", true).ToString();
}
Private Sub GetIfPresent3()
' Creates a new data object using a string and the text format.
Dim myDataObject As New DataObject(DataFormats.Text, "Another string")
' Prints the string in a text box with autoconvert = false.
If myDataObject.GetDataPresent("System.String", False) Then
' Prints the string in a text box.
textBox1.Text = myDataObject.GetData("System.String", False).ToString() & ControlChars.Cr
Else
textBox1.Text = "Could not convert data to specified format" & ControlChars.Cr
End If
' Prints the string in a text box with autoconvert = true.
textBox1.Text &= "With autoconvert = true, you can convert text to string format. " & _
"String is: " & myDataObject.GetData("System.String", True).ToString()
End Sub
Uwagi
Wywołaj tę metodę, aby określić, czy format istnieje przed wywołaniem metody GetData. Wywołaj wywołanie GetFormats formatów dostępnych w tym pliku DataObject.
Ta metoda zwraca wartość true
, gdy:
Parametr
autoConvert
jesttrue
i dane są w formacie, który można przekonwertować na odpowiedni format.Parametr
autoConvert
jestfalse
i dane są w odpowiednim formacie.
Ta metoda zwraca wartość false
, gdy:
Parametr
autoConvert
jesttrue
i ta metoda nie może odnaleźć danych w określonym formacie i nie może przekonwertować danych na określony format lub dane były przechowywane z automatycznym zestawem konwersji nafalse
.Parametr
autoConvert
jestfalse
i dane nie istnieją w tym DataObject formacie.
Uwaga
Dane można przekonwertować na inny format, jeśli były przechowywane, określając, że konwersja jest dozwolona, a żądany format jest zgodny z zapisanym formatem. Na przykład dane przechowywane jako Unicode można przekonwertować na tekst.
Uwaga
Jeśli nie można pobrać żadnych danych, nie zostanie zgłoszony żaden wyjątek.
false
Zamiast tego zostanie zwrócony.