Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Het safe contextuele trefwoord markeert een declaratie omdat er geen unsafe context nodig is op de gebruikssite onder het bijgewerkte model voor geheugenveiligheid. De safe modifier is de tegenhanger van unsafe. Een onveilige context is niet vereist voor bellers van een safe verklaring, terwijl unsafe de verplichting om de veiligheid van de beller te controleren wordt doorgegeven.
Voor het gebruik van het safe trefwoord zelf is de AllowUnsafeBlocks compileroptie (-unsafe) vereist, ook al hebben bellers geen context nodig unsafe . Gewone declaraties zijn standaard veilig, dus laat weg safe waar het niet nodig is om onnodig onveilige compilatie te voorkomen.
Important
Het safe trefwoord maakt deel uit van het bijgewerkte model voor geheugenveiligheid, een preview-functie in C# 15 en .NET 11. Stel LangVersion deze optie in om preview de syntaxis in te schakelen. Als u ook de bijgewerkte regels wilt afdwingen, inclusief expliciete safe of unsafe keuzes en onveilige aanroeperverplichtingen, schakelt u de updated-memory-safety-rules compilerfunctie in. Zie De bijgewerkte regels voor geheugenveiligheid inschakelen voor activeringsdetails. Zie de specificatie van de geheugenveiligheidsfunctie voor het volledige ontwerp.
Toegestane en vereiste declaraties
U kunt van toepassing zijn op safe declaraties die een onveilige modifier toestaan, waaronder methoden, constructors, eigenschappen en velden. Voor gewone declaraties kan de wijzigingsfunctie het beoogde contract expliciet maken, inclusief in broncode gegenereerde code. Het is niet beperkt tot extern leden en indelingsvelden.
Voor bepaalde declaraties is een expliciete keuze safe vereist of unsafe wanneer de bijgewerkte regels zijn ingeschakeld. In de volgende secties worden leden en expliciete of uitgebreide indelingsvelden beschreven extern .
In tegenstelling tot unsafe, safe wordt er geen lexicale context tot stand gebracht. Het maakt onveilige bewerkingen in een lidbody niet veilig of annuleer een onveilige context. U kunt de safe en unsafe modifiers niet combineren op dezelfde declaratie. Dit produceert CS9388.
In nieuwere compilers safe vereisen AllowUnsafeBlocksdeclaraties ook, ook al hebben bellers geen onveilige context nodig. Stel <AllowUnsafeBlocks>true</AllowUnsafeBlocks> in uw projectbestand in om CS9401 om te zetten. Deze wijzigingscontrole is onafhankelijk van de opt-in voor het afdwingen van bijgewerkte regels. Roslyn documenteerde het zoals geïntroduceerd in Visual Studio 2026 versie 18.13, na .NET 11.0.100; de .NET 11 RC2-compiler dwingt deze vereiste safeniet af. Zie Onveilige contextvereisten voor de grens van de compiler en het onderscheid tussen CS0227 en CS0227.
Extern leden
Een extern lid roept systeemeigen code aan, zodat de compiler de veiligheid niet kan classificeren. Onder het bijgewerkte model markeert u elke extern declaratie, inclusief een LibraryImport gedeeltelijke methode, safe of unsafe:
// Syntax requires LangVersion preview; enforcement requires the updated-memory-safety-rules compiler feature.
[LibraryImport("libc")]
internal static safe partial int getpid();
[LibraryImport("libc", StringMarshalling = StringMarshalling.Utf8)]
internal static unsafe partial nint strlen(byte* str);
getpid neemt geen parameters en retourneert een primitieve, dus de auteur bevestigt dat de aanroep veilig is en bellers gebruiken deze zonder context unsafe .
strlen neemt een onbewerkte aanwijzer op dat de systeemeigen codededucties, dus de declaratie is unsafe en de verplichting doorgeeft aan zijn bellers. Als de bijgewerkte regels zijn ingeschakeld, is het weglaten van beide modifiers een fout.
Expliciete of uitgebreide indelingsvelden
In een type met [StructLayout(LayoutKind.Explicit)] of [ExtendedLayout]kan de compiler de veiligheid van elk exemplaarveld niet zelfstandig classificeren. U markeert elk dergelijk veld safe of unsafe:
// Syntax requires LangVersion preview; enforcement requires the updated-memory-safety-rules compiler feature.
[StructLayout(LayoutKind.Explicit)]
internal struct Union
{
[FieldOffset(0)]
internal safe int AsInt;
[FieldOffset(0)]
internal safe float AsFloat;
}
Een veld dat een systeemeigen aanwijzer bevat of waarvan het type anderszins een invariant bevat die het typesysteem niet kan uitdrukken, is unsafe. Een veld waarvan het type volledig wordt beschreven door het typesysteem.safe Dezelfde regel geldt voor expliciete indelingsvelden en uitgebreide indelingsvelden. Net als bij extern leden is het weglaten van beide modifiers een fout wanneer de bijgewerkte regels zijn ingeschakeld.
Pas dezelfde modifiers toe op instantievelden in typen met niet-nul StructLayoutAttribute.Pack of StructLayoutAttribute.Size, inclusief sequentiële en automatische indeling. Voor een type sequentiële indeling met Pack = 1 bijvoorbeeld dezelfde expliciete keuze is vereist. Niet-opgegeven of nulwaarden activeren de extra regel niet zelf. Statische en constante velden zijn uitgesloten. Voor gesynthetiseerde back-upvelden plaatst u de wijzigingsfunctie op de eigenschap of gebeurtenis die eigenaar is.
Zie Voor het CS9392-bericht en oplossingen voor andere gesynthetiseerde opslag de veiligheid van de veldindeling.
C#-taalspecificatie
Zie Onveilige code in de C#-taalspecificatie voor meer informatie. De taalspecificatie is de definitieve bron voor de C#-syntaxis en het gebruik.
Zie de specificatie van de functie voor geheugenveiligheid voor het ontwerp van het bijgewerkte model voor geheugenveiligheid.