CodeTypeDeclaration.IsPartial Propriété

Définition

Espace de noms:

System.CodeDom

Assembly:

System.CodeDom.dll

Paquet:

System.CodeDom v8.0.0

Source:

CodeTypeDeclaration.cs

Obtient ou définit une valeur indiquant si la déclaration de type est complète ou partielle.

public:
 property bool IsPartial { bool get(); void set(bool value); };

public bool IsPartial { get; set; }

member this.IsPartial : bool with get, set

Public Property IsPartial As Boolean

Valeur de propriété

Boolean

true si la déclaration de classe ou de structure est une représentation partielle de l'implémentation ; false si la déclaration est une implémentation complète de la classe ou de la structure. La valeur par défaut est false.

Exemples

Cet exemple illustre l’utilisation d’un CodeTypeDeclaration pour fournir une implémentation de classe sur plusieurs déclarations. L’exemple génère l’instruction de déclaration de classe initiale et définit la IsPartial propriété sur true.

CodeTypeDeclaration^ baseClass = gcnew CodeTypeDeclaration( "DocumentProperties" );
baseClass->IsPartial = true;
baseClass->IsClass = true;
baseClass->Attributes = MemberAttributes::Public;
baseClass->BaseTypes->Add( gcnew CodeTypeReference( System::Object::typeid ) );

// Add the DocumentProperties class to the namespace.
sampleSpace->Types->Add( baseClass );

            CodeTypeDeclaration baseClass = new CodeTypeDeclaration("DocumentProperties");
            baseClass.IsPartial = true;
            baseClass.IsClass = true;
            baseClass.Attributes = MemberAttributes.Public;
            baseClass.BaseTypes.Add(new CodeTypeReference(typeof(System.Object
)));

            // Add the DocumentProperties class to the namespace.
            sampleSpace.Types.Add(baseClass);

Dim baseClass As CodeTypeDeclaration = New CodeTypeDeclaration("DocumentProperties")
baseClass.IsPartial = True
baseClass.IsClass = True
baseClass.Attributes = MemberAttributes.Public
baseClass.BaseTypes.Add(New CodeTypeReference(GetType(System.Object)))

' Add the DocumentProperties class to the namespace.
sampleSpace.Types.Add(baseClass)

Une autre méthode dans l’exemple étend l’implémentation de classe. Cette méthode génère une nouvelle instruction de déclaration de type pour la classe existante et définit la IsPartial propriété sur true. Le compilateur combine les deux déclarations de type partiel pour l’implémentation de classe complète.

CodeTypeDeclaration^ baseClass = gcnew CodeTypeDeclaration( "DocumentProperties" );
baseClass->IsPartial = true;
baseClass->IsClass = true;
baseClass->Attributes = MemberAttributes::Public;

// Extend the DocumentProperties class in the unit namespace.
( *docPropUnit)->Namespaces[ 0 ]->Types->Add( baseClass );

CodeTypeDeclaration baseClass = new CodeTypeDeclaration("DocumentProperties");
baseClass.IsPartial = true;
baseClass.IsClass = true;
baseClass.Attributes = MemberAttributes.Public;

// Extend the DocumentProperties class in the unit namespace.
docPropUnit.Namespaces[0].Types.Add(baseClass);

Dim baseClass As CodeTypeDeclaration = New CodeTypeDeclaration("DocumentProperties")
baseClass.IsPartial = True
baseClass.IsClass = True
baseClass.Attributes = MemberAttributes.Public

' Extend the DocumentProperties class in the unit namespace.
docPropUnit.Namespaces(0).Types.Add(baseClass)

Remarques

Vous pouvez créer une implémentation de classe ou de structure dans une déclaration complète, ou répartir l’implémentation entre plusieurs déclarations. Les implémentations sont généralement fournies dans une déclaration de type complète. Dans ce cas, définissez la propriété de déclaration IsPartial de type sur false, ce qui indique que la déclaration de type représente tous les détails de l’implémentation de la classe ou de la structure.

Une déclaration de type partielle facilite la création de différentes parties d’une implémentation de classe ou de structure dans différents modules de votre application. Les déclarations de type partiel peuvent être stockées dans un seul fichier source ou réparties sur plusieurs fichiers sources qui sont finalement compilés ensemble pour former l’implémentation de type combiné.

Le langage C# prend en charge les déclarations de type partielles de classes et de structures via le partial mot clé. Visual Basic prend en charge les déclarations de type partielles de classes et de structures avec le Partial mot clé. Tous les générateurs de code ne prennent pas en charge les déclarations de type partielles. Vous devez donc tester cette prise en charge en appelant la Supports méthode avec l’indicateur PartialTypes.

Notes

Les déclarations de type partiel sont prises en charge pour les classes et les structures. Si vous spécifiez une déclaration de type partielle pour une énumération ou une interface, le code généré génère des erreurs du compilateur.

Lorsque vous fournissez une implémentation de classe ou de structure sur plusieurs déclarations, définissez la IsPartial propriété true sur pour la déclaration initiale et toutes les déclarations supplémentaires. La déclaration initiale doit spécifier entièrement la signature de type, y compris les modificateurs d’accès, les types hérités et les interfaces implémentées. Les déclarations supplémentaires n’ont pas besoin de spécifier à nouveau la signature de type. Une erreur du compilateur se produit généralement si vous redéfinissez la signature de type dans une déclaration supplémentaire.

Visual Studio 2005 utilise des types partiels pour séparer le code généré par l’utilisateur du code du concepteur. Dans les projets d’application Windows Visual Basic, le code utilisateur est placé dans une classe partielle qui n’est pas qualifiée par le Partial mot clé ; le code fourni par le concepteur apparaît dans la classe partielle qui a le Partial mot clé. En C#, le code utilisateur et le code du concepteur apparaissent dans des classes partielles identifiées par le partial mot clé.

Voir aussi

• PartialTypes