DataObject.GetDataPresent Méthode

Référence

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 sont associées au format spécifié.

Surcharges

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

GetDataPresent(String)

Détermine si les données stockées dans ce DataObject sont associées au format spécifié ou si elles peuvent être converties dans le 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 pour obtenir les formats prédéfinis.

Retours

Boolean

true si les données stockées dans ce DataObject 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 sont associées à un format spécifié ou si elles peuvent être converties vers 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 indiquent si des données de texte existent dans le DataObject. Ce code nécessite que ait textBox1 été créé.

Remarques

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

Notes

Les données peuvent être converties dans un autre format si elles ont été stockées en spécifiant que la conversion est autorisée et si le format demandé est compatible avec le format stocké. Par exemple, les données stockées au format Unicode peuvent être converties en texte.

Notes

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

Voir aussi

S’applique à

GetDataPresent(Type)

Détermine si les données stockées dans ce DataObject sont associées au format spécifié ou si elles peuvent être converties dans le 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

Type représentant le format à vérifier.

Retours

Boolean

true si les données stockées dans ce DataObject 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 vers le type spécifié. Le résultat s’affiche dans une zone de texte. Le code exige que ait textBox1 été créé.

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

Notes

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

Voir aussi

S’applique à

GetDataPresent(String, Boolean)

Détermine si ce DataObject contient des données au format spécifié, ou qui peuvent éventuellement être converties dans le 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 pour obtenir les formats prédéfinis.

autoConvert: Boolean

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

Retours

Boolean

true en présence de données dans le format spécifié ou en cas de possibilité de conversion des données dans le 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 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, le DataObject est interrogé pour les données associées au format de texte, en spécifiant le autoConvert paramètre comme false. Le résultat de cette requête est imprimé dans une zone de texte.

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

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

Cette méthode retourne true quand :

Le autoConvert paramètre est true et les données sont 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 dans le format spécifié.

Notes

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

Voir aussi

S’applique à

Partager via

DataObject.GetDataPresent Méthode

Définition

Surcharges

GetDataPresent(String)

Paramètres

Retours

Implémente

Exemples

Remarques

Voir aussi

S’applique à

GetDataPresent(Type)

Paramètres

Retours

Implémente

Exemples

Remarques

Voir aussi

S’applique à

GetDataPresent(String, Boolean)

Paramètres

Retours

Implémente

Exemples

Remarques

Voir aussi

S’applique à

Ressources supplémentaires