IDataObject.GetDataPresent Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Windows.Forms

Zestaw:: System.Windows.Forms.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.

Określa, czy dane przechowywane w tym wystąpieniu są skojarzone z określonym formatem.

Przeciążenia

GetDataPresent(String)	Określa, czy dane przechowywane w tym wystąpieniu są skojarzone z określonym formatem lub można je przekonwertować na.
GetDataPresent(Type)	Określa, czy dane przechowywane w tym wystąpieniu są skojarzone z określonym formatem lub można je przekonwertować na.
GetDataPresent(String, Boolean)	Określa, czy dane przechowywane w tym wystąpieniu są skojarzone z określonym formatem przy użyciu wartości logicznej w celu określenia, czy dane mają być konwertowane na format.

GetDataPresent(String)

Określa, czy dane przechowywane w tym wystąpieniu są skojarzone z określonym formatem lub można je przekonwertować na.

public:
 bool GetDataPresent(System::String ^ format);

public bool GetDataPresent (string format);

abstract member GetDataPresent : string -> bool

Public Function GetDataPresent (format As String) As Boolean

Parametry

format: String

Format, dla którego ma być sprawdzany. Zobacz, aby zapoznać się DataFormats ze wstępnie zdefiniowanymi formatami.

Zwraca

Boolean

true jeśli dane przechowywane w tym wystąpieniu są skojarzone lub mogą być konwertowane na określony format; w przeciwnym razie false.

Przykłady

W tym przykładzie DataObject użyto klasy , która implementuje IDataObjectmetodę GetDataPresent , aby zademonstrować użycie metody . Najpierw tworzy obiekt danych przy użyciu ciągu i Text formatu. Następnie sprawdza, czy dane są obecne w Text formacie i wyświetla wyniki w polu komunikatu. W przykładzie założono, że utworzono Form nazwę Form1.

private:
   void TestDataObject()
   {
      // Creates a new data object using a string and the Text format.
      String^ myString = "Hello World!";
      DataObject^ myDataObject = gcnew DataObject( DataFormats::Text,myString );

      // Checks whether the data is present in the Text format and displays the result.
      if ( myDataObject->GetDataPresent( DataFormats::Text ) )
            MessageBox::Show( "The stored data is in the Text format.", "Test Result" );
      else
            MessageBox::Show( "The stored data is not in the Text format.", "Test Result" );
   }

       private void TestDataObject() 
       {
           // Creates a new data object using a string and the Text format.
           string myString = "Hello World!";
           DataObject myDataObject = new DataObject(DataFormats.Text, myString);

           // Checks whether the data is present in the Text format and displays the result.
           if (myDataObject.GetDataPresent(DataFormats.Text))
               MessageBox.Show("The stored data is in the Text format." , "Test Result");
           else
               MessageBox.Show("The stored data is not in the Text format.", "Test Result");
       }

Private Sub TestDataObject()
    ' Creates a new data object using a string and the Text format.
    Dim myString As New String("Hello World!")
    Dim myDataObject As New DataObject(DataFormats.Text, myString)

    ' Checks whether the data is present in the Text format and displays the result.
    If (myDataObject.GetDataPresent(DataFormats.Text)) Then
        MessageBox.Show("The stored data is in the Text format.", "Test Result")
    Else
        MessageBox.Show("The stored data is not in the Text format.", "Test Result")
    End If
End Sub

Uwagi

Wywołaj tę metodę, aby określić, czy format istnieje w tym DataObject przed wywołaniem metody GetData. Wywołaj wywołanie GetFormats formatów dostępnych w tym wystąpieniu.

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.

Aby zapoznać się z implementacją tej metody, zobacz DataObject.GetDataPresent.

Zobacz też

Dotyczy

GetDataPresent(Type)

Określa, czy dane przechowywane w tym wystąpieniu są skojarzone z określonym formatem lub można je przekonwertować na.

public:
 bool GetDataPresent(Type ^ format);

public bool GetDataPresent (Type format);

abstract member GetDataPresent : Type -> bool

Public Function GetDataPresent (format As Type) As Boolean

Parametry

format: Type

Reprezentująca Type format, dla którego ma być sprawdzana. Zobacz, aby zapoznać się DataFormats ze wstępnie zdefiniowanymi formatami.

Zwraca

Boolean

true jeśli dane przechowywane w tym wystąpieniu są skojarzone lub mogą być konwertowane na określony format; w przeciwnym razie , false.

Przykłady

W tym przykładzie DataObject użyto klasy , która implementuje IDataObjectmetodę GetDataPresent , aby zademonstrować użycie metody . Najpierw tworzy składnik (myComponent) i przechowuje go w obiekcie danych (myDataObject). Następnie sprawdza, czy określone dane są przechowywane w obiekcie myDataObject. Jeśli test oceni true, wyświetla wynik w polu komunikatu i wyświetla typ danych w polu tekstowym. W tym przykładzie założono, że utworzono już Form nazwę Form1 i TextBox nazwę textBox1.

private:
   void GetDataPresent2()
   {
      // 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();

      // Checks whether the specified data type exists in the object.
      if ( myDataObject->GetDataPresent( myType ) )
      {
         MessageBox::Show( "The specified data is stored in the data object." );

         // Displays the type of data.
         textBox1->Text = "The data type is " + myDataObject->GetData( myType )->GetType()->Name + ".";
      }
      else
            MessageBox::Show( "The specified data is not stored in the data object." );
   }

       private void GetDataPresent2() 
       {
           // 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();

           // Checks whether the specified data type exists in the object.
           if (myDataObject.GetDataPresent(myType))
           {
               MessageBox.Show("The specified data is stored in the data object.");
               // Displays the type of data.
               textBox1.Text = "The data type is " + myDataObject.GetData(myType).GetType().Name + ".";
           }
           else
           {
               MessageBox.Show("The specified data is not stored in the data object.");
           }
       }

Private Sub GetDataPresent2()
    ' Creates a component to store in the data object.
    Dim myComponent As New System.ComponentModel.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()

    ' Checks whether the specified data type exists in the object.
    If myDataObject.GetDataPresent(myType) Then
        MessageBox.Show("The specified data is stored in the data object.")
        ' Displays the type of data.
        TextBox1.Text = "The data type is " & myDataObject.GetData(myType).GetType().Name & "."
    Else
        MessageBox.Show("The specified data is not stored in the data object.")
    End If
End Sub

Uwagi

Wywołaj tę metodę, aby określić, czy format istnieje w tym DataObject przed wywołaniem metody GetData. Wywołaj wywołanie GetFormats formatów dostępnych w tym wystąpieniu.

Uwaga

Aby zapoznać się z implementacją tej metody, zobacz DataObject.GetDataPresent.

Zobacz też

Dotyczy

GetDataPresent(String, Boolean)

Określa, czy dane przechowywane w tym wystąpieniu są skojarzone z określonym formatem przy użyciu wartości logicznej w celu określenia, czy dane mają być konwertowane na format.

public:
 bool GetDataPresent(System::String ^ format, bool autoConvert);

public bool GetDataPresent (string format, bool autoConvert);

abstract member GetDataPresent : string * bool -> bool

Public Function GetDataPresent (format As String, autoConvert As Boolean) As Boolean

Parametry

format: String

Format, dla którego ma być sprawdzany. Zobacz, aby zapoznać się DataFormats ze wstępnie zdefiniowanymi formatami.

autoConvert: Boolean

true aby określić, czy dane przechowywane w tym wystąpieniu można przekonwertować na określony format; false aby sprawdzić, czy dane są w określonym formacie.

Zwraca

Boolean

true jeśli dane są w obiekcie lub można je przekonwertować na określony format; w przeciwnym razie , false.

Przykłady

W tym przykładzie DataObject użyto klasy , która implementuje IDataObjectmetodę GetDataPresent , aby zademonstrować użycie metody . Najpierw tworzy obiekt danych (myDataObject) przy użyciu ciągu i Text formatu. Następnie wysyła zapytanie do obiektu dla danych skojarzonych z Text formatem z parametrem ustawionym autoConvert na falsewartość . Ta wersja próbna kończy się niepowodzeniem, a wynik jest wyświetlany w polu komunikatu z etykietą "Message #1". W drugiej wersji próbnej ustawia autoConvert parametr na true. Ta wersja próbna zakończy się pomyślnie, a wynik zostanie wyświetlony w polu komunikatu z etykietą "Message #2". W przykładzie założono, że utworzono Form nazwę Form1.

private:
   void GetDataPresent3()
   {
      // Creates a new data object using a string and the Text format.
      DataObject^ myDataObject = gcnew DataObject( DataFormats::Text,"My String" );

      // Checks whether the string can be displayed with autoConvert equal to false.
      if ( myDataObject->GetDataPresent( "System::String", false ) )
            MessageBox::Show( myDataObject->GetData( "System::String", false )->ToString(), "Message #1" );
      else
            MessageBox::Show( "Cannot convert data to the specified format with autoConvert set to false.", "Message #1" );

      // Displays the string with autoConvert equal to true.
      MessageBox::Show( "Now that autoConvert is true, you can convert " + myDataObject->GetData( "System::String", true ) + " to string format.", "Message #2" );
   }

       private void GetDataPresent3() 
       {
           // Creates a new data object using a string and the Text format.
           DataObject myDataObject = new DataObject(DataFormats.Text, "My String");

           // Checks whether the string can be displayed with autoConvert equal to false.
           if(myDataObject.GetDataPresent("System.String", false)) 
               MessageBox.Show(myDataObject.GetData("System.String", false).ToString(), "Message #1");
           else
               MessageBox.Show("Cannot convert data to the specified format with autoConvert set to false.", "Message #1");

           // Displays the string with autoConvert equal to true.
           MessageBox.Show("Now that autoConvert is true, you can convert " + 
               myDataObject.GetData("System.String", true).ToString() + " to string format.","Message #2");
       }

Private Sub GetDataPresent3()
    ' Creates a new data object using a string and the Text format.
    Dim myDataObject As New DataObject(DataFormats.Text, "My String")

    ' Checks whether the string can be displayed with autoConvert equal to false.
    If myDataObject.GetDataPresent("System.String", False) Then
        MessageBox.Show(myDataObject.GetData("System.String", False).ToString() + ".", "Message #1")
    Else
        MessageBox.Show("Cannot convert data to the specified format with autoConvert set to false.", "Message #1")
    End If
    ' Displays the string with autoConvert equal to true.
    MessageBox.Show(("Now that autoConvert is true, you can convert " + myDataObject.GetData("System.String", _
         True).ToString() + " to string format."), "Message #2")

End Sub

Uwagi

Wywołaj tę metodę, aby określić, czy format istnieje w tym DataObject przed wywołaniem metody GetData. Wywołaj wywołanie GetFormats formatów dostępnych w tym wystąpieniu.

Ta metoda zwraca wartość true , gdy:

Parametr autoConvert jest true i dane są w formacie, który można przekonwertować na odpowiedni format.
Parametr autoConvert jest false i dane są w odpowiednim formacie.

Ta metoda zwraca wartość false , gdy:

Parametr autoConvert jest 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 ustawioną wartością autoConvertfalse.true
Parametr autoConvert to false, a dane nie istnieją w tym wystąpieniu w określonym formacie.

Uwaga

Aby zapoznać się z implementacją tej metody, zobacz DataObject.GetDataPresent.

Zobacz też

Dotyczy

IDataObject.GetDataPresent Metoda

Definicja

Przeciążenia

GetDataPresent(String)

Parametry

Zwraca

Przykłady

Uwagi

Zobacz też

Dotyczy

GetDataPresent(Type)

Parametry

Zwraca

Przykłady

Uwagi

Zobacz też

Dotyczy

GetDataPresent(String, Boolean)

Parametry

Zwraca

Przykłady

Uwagi

Zobacz też

Dotyczy

Opinia

Dodatkowe zasoby