DataObject.GetDataPresent Méthode

Définition

Espace de noms:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Détermine si les données stockées dans ce DataObject format sont associées au format spécifié.

Surcharges

Nom	Description
GetDataPresent(String)	Détermine si les données stockées dans ce DataObject fichier sont associées ou peuvent être converties au format spécifié.
GetDataPresent(Type)	Détermine si les données stockées dans ce DataObject fichier sont associées ou peuvent être converties au format spécifié.
GetDataPresent(String, Boolean)	Détermine si cela DataObject contient des données au format spécifié ou, éventuellement, contient des données qui peuvent être converties au format spécifié.

GetDataPresent(String)

Détermine si les données stockées dans ce DataObject fichier sont associées ou peuvent être converties au format spécifié.

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

Paramètres

format: String

Format à vérifier. Consultez DataFormats les formats prédéfinis.

Retours

Boolean

true si les données stockées dans ce DataObject fichier sont associées ou peuvent être converties au format spécifié ; sinon, false.

Implémente

GetDataPresent(String)

Exemples

L’exemple de code suivant détermine si les données actuellement stockées dans ce DataObject fichier sont associées ou peuvent être converties dans un format spécifié. Un nouveau DataObject est initialisé avec une chaîne et son format associé spécifié en tant que texte.

Ensuite, les exemples impriment si des données de texte existent dans le DataObject. Ce code nécessite la textBox1 création.

Remarques

Appelez cette méthode pour déterminer si un format existe avant d’appeler GetData. Appelez GetFormats les formats disponibles dans ce DataObjectfichier .

Note

Les données peuvent être converties dans un autre format s’il a été stocké en spécifiant que cette conversion est autorisée et si le format demandé est compatible avec le format stocké. Par exemple, les données stockées en tant qu’Unicode peuvent être converties en texte.

Note

Si aucune donnée ne peut être récupérée, aucune exception n’est levée. Au lieu de cela, false sera retourné.

Voir aussi

S’applique à

GetDataPresent(Type)

Détermine si les données stockées dans ce DataObject fichier sont associées ou peuvent être converties au format spécifié.

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

Paramètres

format: Type

Représentant Type le format à rechercher.

Retours

Boolean

true si les données stockées dans ce DataObject fichier sont associées ou peuvent être converties au format spécifié ; sinon, false.

Implémente

GetDataPresent(Type)

Exemples

L’exemple de code suivant détermine si les données du type spécifié existent dans un DataObject, ou si les données peuvent être converties en type spécifié. Le résultat est affiché dans une zone de texte. Le code nécessite la textBox1 création.

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

Remarques

Appelez cette méthode pour déterminer si un format existe avant d’appeler GetData. Appelez GetFormats les formats disponibles dans ce DataObjectfichier .

Note

Si aucune donnée ne peut être récupérée, aucune exception n’est levée. Au lieu de cela, false sera retourné.

Voir aussi

S’applique à

GetDataPresent(String, Boolean)

Détermine si cela DataObject contient des données au format spécifié ou, éventuellement, contient des données qui peuvent être converties au format spécifié.

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

Paramètres

format: String

Format à vérifier. Consultez DataFormats les formats prédéfinis.

autoConvert: Boolean

true pour déterminer si les données stockées dans ce DataObject format peuvent être converties au format spécifié ; false pour vérifier si les données se trouvent dans le format spécifié.

Retours

Boolean

true si les données se trouvent ou peuvent être converties au format spécifié ; sinon, false.

Implémente

GetDataPresent(String, Boolean)

Exemples

L’exemple de code suivant détermine si les données actuellement stockées dans le DataObject fichier sont associées à un format spécifié. Tout d’abord, un nouveau DataObject est initialisé avec une chaîne, en spécifiant son format en tant que texte.

Ensuite, il DataObject est interrogé pour les données associées au format texte, en spécifiant le autoConvert paramètre en tant que false. Le résultat de cette requête est imprimé dans une zone de texte.

Ensuite, il DataObject est interrogé pour les données associées au format de chaîne, en spécifiant le autoConvert paramètre en tant que true. Les résultats sont imprimés dans la zone de texte. Ce code nécessite la textBox1 création.

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

Remarques

Appelez cette méthode pour déterminer si un format existe avant d’appeler GetData. Appelez GetFormats les formats disponibles dans ce DataObjectfichier .

Cette méthode retourne true quand :

Le autoConvert paramètre est true et les données se trouvent dans un format qui peut être converti au format approprié.
Le autoConvert paramètre est false et les données sont au format approprié.

Cette méthode retourne false quand :

Le autoConvert paramètre est true et cette méthode ne peut pas trouver de données dans le format spécifié, et elle ne peut pas convertir les données au format spécifié, ou les données ont été stockées avec la conversion automatique définie sur false.
Le autoConvert paramètre est false et les données n’existent pas dans ce DataObject format dans le format spécifié.

Note

Si aucune donnée ne peut être récupérée, aucune exception n’est levée. Au lieu de cela, false sera retourné.

Voir aussi

S’applique à

Commentaires

Cette page a-t-elle été utile ?