Skip to content

Latest commit

 

History

History
79 lines (68 loc) · 2.35 KB

File metadata and controls

79 lines (68 loc) · 2.35 KB
title <permission> (Visual C++) | Microsoft Docs
ms.custom
ms.date 11/04/2016
ms.reviewer
ms.suite
ms.technology
cpp-ide
ms.tgt_pltfrm
ms.topic article
f1_keywords
permission
<permission>
dev_langs
C++
helpviewer_keywords
<permission> C++ XML tag
permission C++ XML tag
ms.assetid 537ee2bc-95bd-48e4-9ce6-3420c3da87f4
caps.latest.revision 11
author mikeblome
ms.author mblome
manager ghogen
translation.priority.ht
cs-cz
de-de
es-es
fr-fr
it-it
ja-jp
ko-kr
pl-pl
pt-br
ru-ru
tr-tr
zh-cn
zh-tw

<permission> (Visual C++)

The <permission> tag lets you document the access of a member. xref:System.Security.PermissionSet lets you specify access to a member.

Syntax

<permission cref="member">description</permission>  

Parameters

member
A reference to a member or field that is available to be called from the current compilation environment. The compiler checks that the given code element exists and translates member to the canonical element name in the output XML. Enclose the name in single or double quotation marks.

The compiler issues a warning if it does not find member.

For information on how to create a cref reference to a generic type, see <see>.

description
A description of the access to the member.

Remarks

Compile with /doc to process documentation comments to a file.

The Visual C++ compiler will attempt to resolve cref references in one pass through the documentation comments. Therefore, if using the C++ lookup rules, a symbol is not found by the compiler the reference will be marked as unresolved. See <seealso> for more information.

Example

// xml_permission_tag.cpp  
// compile with: /clr /doc /LD  
// post-build command: xdcmake xml_permission_tag.dll  
using namespace System;  
/// Text for class TestClass.  
public ref class TestClass {  
   /// <permission cref="System::Security::PermissionSet">Everyone can access this method.</permission>  
   void Test() {}  
};  

See Also

XML Documentation