CodeTypeDeclaration.IsPartial Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de typedeclaratie volledig of gedeeltelijk is.
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
Waarde van eigenschap
true indien de klasse- of structuurdeclaratie een gedeeltelijke weergave van de uitvoering is; false als de declaratie een volledige implementatie van de klasse of structuur is. De standaardwaarde is false.
Voorbeelden
In dit voorbeeld ziet u hoe u een CodeTypeDeclaration klasse-implementatie kunt leveren voor meerdere declaraties. In het voorbeeld wordt de initiële instructie voor klassedeclaratie gebouwd en wordt de IsPartial eigenschap ingesteld op true.
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)
Met een andere methode in het voorbeeld wordt de klasse-implementatie uitgebreid. Met deze methode wordt een nieuwe typedeclaratie-instructie voor de bestaande klasse gebouwd en wordt de IsPartial eigenschap ingesteld op true. De compiler combineert de twee gedeeltelijke declaraties voor de volledige klasse-implementatie.
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)
Opmerkingen
U kunt een klasse- of structuur-implementatie bouwen in één volledige declaratie of de implementatie verspreiden over meerdere declaraties. Implementaties worden meestal geleverd in één volledige typedeclaratie. Stel in dit geval de eigenschap falsetypedeclaratie IsPartial in op , waarmee wordt aangegeven dat de typedeclaratie alle details voor de klasse- of structuur-implementatie vertegenwoordigt.
Een gedeeltelijke typedeclaratie maakt het eenvoudiger om verschillende delen van een klasse- of structuur-implementatie in verschillende modules van uw toepassing te bouwen. De gedeeltelijke typedeclaraties kunnen worden opgeslagen in één bronbestand of worden verspreid over meerdere bronbestanden die uiteindelijk samen worden gecompileerd om de gecombineerde type-implementatie te vormen.
De C#-taal ondersteunt gedeeltelijke typedeclaraties van klassen en structuren via het partial trefwoord. Visual Basic ondersteunt gedeeltelijke typedeclaraties van klassen en structuren met het trefwoord Partial. Niet alle codegeneratoren ondersteunen gedeeltelijke typedeclaraties, dus u moet deze ondersteuning testen door de Supports methode aan te roepen met de vlag PartialTypes.
Opmerking
Gedeeltelijke typedeclaraties worden ondersteund voor klassen en structuren. Als u een gedeeltelijke typedeclaratie opgeeft voor een opsomming of interface, produceert de gegenereerde code compilerfouten.
Bij het leveren van een klasse- of structuur-implementatie voor meerdere declaraties, stelt u de IsPartial eigenschap true in op voor de eerste declaratie en alle aanvullende declaraties. De eerste declaratie moet de handtekening van het type volledig opgeven, inclusief wijzigingsaanpassingen voor toegang, overgenomen typen en geïmplementeerde interfaces. De aanvullende declaraties hoeven de typehandtekening niet opnieuw op te geven. Een compilerfout treedt meestal op als u de typehandtekening opnieuw definieert in een aanvullende declaratie.
Visual Studio 2005 maakt gebruik van gedeeltelijke typen om door de gebruiker gegenereerde code te scheiden van ontwerpcode. In Visual Basic Windows Toepassingsprojecten wordt de gebruikerscode in een gedeeltelijke klasse geplaatst die niet is gekwalificeerd door het trefwoord Partial; de door de ontwerper geleverde code wordt weergegeven in de gedeeltelijke klasse met het trefwoord Partial. In C# worden zowel de gebruikerscode als de ontwerpcode weergegeven in gedeeltelijke klassen die worden geïdentificeerd door het partial trefwoord.