IDataObject.GetDataPresent Metod

Definition

Namnområde:: System.Windows.Forms

Sammansättning:: System.Windows.Forms.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Avgör om data som lagras i den här instansen är associerade med det angivna formatet.

Överlagringar

Name	Description
GetDataPresent(String)	Avgör om data som lagras i den här instansen är associerade med eller kan konverteras till det angivna formatet.
GetDataPresent(Type)	Avgör om data som lagras i den här instansen är associerade med eller kan konverteras till det angivna formatet.
GetDataPresent(String, Boolean)	Avgör om data som lagras i den här instansen är associerade med det angivna formatet med hjälp av ett booleskt värde för att avgöra om data ska konverteras till formatet.

GetDataPresent(String)

Källa:: IDataObject.cs

Källa:: IDataObject.cs

Källa:: IDataObject.cs

Källa:: IDataObject.cs

Källa:: IDataObject.cs

Avgör om data som lagras i den här instansen är associerade med eller kan konverteras till det angivna formatet.

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

public bool GetDataPresent(string format);

abstract member GetDataPresent : string -> bool

Public Function GetDataPresent (format As String) As Boolean

Parametrar

format: String

Vilket format du vill kontrollera. Se DataFormats fördefinierade format.

Returer

Boolean

true om data som lagras i den här instansen är associerade med, eller kan konverteras till, det angivna formatet. annars false.

Exempel

I det DataObject här exemplet används klassen, som implementerar IDataObject, för att demonstrera användningen av GetDataPresent metoden. Först skapar det ett dataobjekt med hjälp av en sträng och Text formatet. Sedan verifieras att data finns i Text formatet och visar resultatet i en meddelanderuta. Exemplet förutsätter att du har skapat en Form med namnet 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

Kommentarer

Anropa den här metoden för att avgöra om det finns ett format i detta DataObject innan du anropar GetData. Anropa GetFormats de format som är tillgängliga i den här instansen.

Note

Data kan konverteras till ett annat format om de har lagrats och anger att konvertering tillåts och om det begärda formatet är kompatibelt med det lagrade formatet. Data som lagras som Unicode kan till exempel konverteras till text.

En implementering av den här metoden finns i DataObject.GetDataPresent.

Se även

Gäller för

GetDataPresent(Type)

Källa:: IDataObject.cs

Källa:: IDataObject.cs

Källa:: IDataObject.cs

Källa:: IDataObject.cs

Källa:: IDataObject.cs

Avgör om data som lagras i den här instansen är associerade med eller kan konverteras till det angivna formatet.

public:
 bool GetDataPresent(Type ^ format);

public bool GetDataPresent(Type format);

abstract member GetDataPresent : Type -> bool

Public Function GetDataPresent (format As Type) As Boolean

Parametrar

format: Type

Ett Type format som ska kontrolleras. Se DataFormats fördefinierade format.

Returer

Boolean

trueom data som lagras i den här instansen är associerade med, eller kan konverteras till, det angivna formatet. annars . false

Exempel

I det DataObject här exemplet används klassen, som implementerar IDataObject, för att demonstrera användningen av GetDataPresent metoden. Först skapar den en komponent (myComponent) och lagrar den i ett dataobjekt (myDataObject). Sedan kontrollerar den om angivna data lagras i myDataObject. Om testet utvärderas truevisas resultatet i en meddelanderuta och datatypen visas i en textruta. Det här exemplet förutsätter att du redan har skapat ett Form namngivet Form1 och ett TextBox med namnet 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

Kommentarer

Anropa den här metoden för att avgöra om det finns ett format i detta DataObject innan du anropar GetData. Anropa GetFormats de format som är tillgängliga i den här instansen.

Note

En implementering av den här metoden finns i DataObject.GetDataPresent.

Se även

Gäller för

GetDataPresent(String, Boolean)

Källa:: IDataObject.cs

Källa:: IDataObject.cs

Källa:: IDataObject.cs

Källa:: IDataObject.cs

Källa:: IDataObject.cs

Avgör om data som lagras i den här instansen är associerade med det angivna formatet med hjälp av ett booleskt värde för att avgöra om data ska konverteras till formatet.

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

Parametrar

format: String

Vilket format du vill kontrollera. Se DataFormats fördefinierade format.

autoConvert: Boolean

true för att avgöra om data som lagras i den här instansen kan konverteras till det angivna formatet. false för att kontrollera om data är i det angivna formatet.

Returer

Boolean

trueom data finns i, eller kan konverteras till, det angivna formatet; annars . false

Exempel

I det DataObject här exemplet används klassen, som implementerar IDataObject, för att demonstrera användningen av GetDataPresent metoden. Först skapar den ett dataobjekt (myDataObject) med hjälp av en sträng och Text formatet. Sedan frågar den objektet efter data som är associerade med Text formatet, med parametern autoConvert inställd på false. Den här utvärderingsversionen misslyckas och resultatet visas i en meddelanderuta med etiketten "Meddelande nr 1". I den andra utvärderingsversionen anger den parametern autoConvert till true. Den här utvärderingsversionen lyckas och resultatet visas i en meddelanderuta med etiketten "Meddelande nr 2". Exemplet förutsätter att du har skapat en Form med namnet 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

Kommentarer

Anropa den här metoden för att avgöra om det finns ett format i detta DataObject innan du anropar GetData. Anropa GetFormats de format som är tillgängliga i den här instansen.

Den här metoden returnerar true när:

Parametern autoConvert är true och data är i ett format som kan konverteras till lämpligt format.
Parametern autoConvert är false och data är i lämpligt format.

Den här metoden returnerar false när:

Parametern autoConvert är true och den här metoden kan inte hitta data i det angivna formatet och kan inte konvertera data till det angivna formatet, eller så har data lagrats med autoConvert värdet false.
Parametern autoConvert är false, och data finns inte i den här instansen i det angivna formatet.

Note

En implementering av den här metoden finns i DataObject.GetDataPresent.

Se även

Gäller för

Feedback

Var den här sidan till hjälp?