SecurityException 建構函式
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
初始化 SecurityException 類別的新執行個體。
多載
SecurityException() |
使用預設屬性,初始化 SecurityException 類別的新執行個體。 |
SecurityException(String) |
使用指定的錯誤訊息,初始化 SecurityException 類別的新執行個體。 |
SecurityException(SerializationInfo, StreamingContext) |
已淘汰.
使用序列化資料,初始化 SecurityException 類別的新執行個體。 |
SecurityException(String, Exception) |
使用指定的錯誤訊息以及造成此例外狀況的內部例外狀況的參考,初始化 SecurityException 類別的新執行個體。 |
SecurityException(String, Type) |
使用指定的錯誤訊息以及造成例外狀況擲回的權限類型,初始化 SecurityException 類別的新執行個體。 |
SecurityException(String, Type, String) |
使用指定的錯誤訊息、造成例外狀況擲回的權限類型以及權限狀態,初始化 SecurityException 類別的新執行個體。 |
SecurityException(String, Object, Object, MethodInfo, Object, IPermission) |
針對此堆疊上 Deny 所造成例外狀況,初始化 SecurityException 類別的新執行個體。 |
SecurityException(String, AssemblyName, PermissionSet, PermissionSet, MethodInfo, SecurityAction, Object, IPermission, Evidence) |
針對沒有足夠授權集所造成的例外狀況,初始化 SecurityException 類別的新執行個體。 |
範例
如需使用建構函式的 SecurityException 範例,請參閱針對建 SecurityException(String, Object, Object, MethodInfo, Object, IPermission) 構函式提供的範例。
SecurityException()
使用預設屬性,初始化 SecurityException 類別的新執行個體。
public:
SecurityException();
public SecurityException ();
Public Sub New ()
範例
如需使用建構函式的 SecurityException 範例,請參閱針對建 SecurityException(String, Object, Object, MethodInfo, Object, IPermission) 構函式提供的範例。
備註
下表顯示 SecurityException 類別執行個體的初始屬性值。
屬性 | 值 |
---|---|
InnerException | null 參考 (在 Visual Basic 中為 Nothing )。 |
Message | 當地語系化的錯誤訊息字串。 |
適用於
SecurityException(String)
使用指定的錯誤訊息,初始化 SecurityException 類別的新執行個體。
public:
SecurityException(System::String ^ message);
public SecurityException (string message);
public SecurityException (string? message);
new System.Security.SecurityException : string -> System.Security.SecurityException
Public Sub New (message As String)
參數
- message
- String
解釋例外狀況原因的錯誤訊息。
範例
如需使用建構函式的 SecurityException 範例,請參閱針對建 SecurityException(String, Object, Object, MethodInfo, Object, IPermission) 構函式提供的範例。
備註
下表顯示 SecurityException 類別執行個體的初始屬性值。
屬性 | 值 |
---|---|
InnerException | null 參考 (在 Visual Basic 中為 Nothing )。 |
Message | 當地語系化的錯誤訊息字串。 |
適用於
SecurityException(SerializationInfo, StreamingContext)
警告
This API supports obsolete formatter-based serialization. It should not be called or extended by application code.
使用序列化資料,初始化 SecurityException 類別的新執行個體。
protected:
SecurityException(System::Runtime::Serialization::SerializationInfo ^ info, System::Runtime::Serialization::StreamingContext context);
protected SecurityException (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);
[System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
protected SecurityException (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);
new System.Security.SecurityException : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.Security.SecurityException
[<System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new System.Security.SecurityException : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.Security.SecurityException
Protected Sub New (info As SerializationInfo, context As StreamingContext)
參數
- info
- SerializationInfo
存放序列物件資料的物件。
- context
- StreamingContext
關於來源或目的端的內容資訊。
- 屬性
例外狀況
info
為 null
。
範例
如需使用建構函式的 SecurityException 範例,請參閱針對建 SecurityException(String, Object, Object, MethodInfo, Object, IPermission) 構函式提供的範例。
備註
這個建構函式是在還原序列化期間呼叫,以便重新組成透過資料流傳輸的例外狀況物件。
此建構函式會根據 參數中 info
的資訊設定下列屬性值:
適用於
SecurityException(String, Exception)
使用指定的錯誤訊息以及造成此例外狀況的內部例外狀況的參考,初始化 SecurityException 類別的新執行個體。
public:
SecurityException(System::String ^ message, Exception ^ inner);
public SecurityException (string message, Exception inner);
public SecurityException (string? message, Exception? inner);
new System.Security.SecurityException : string * Exception -> System.Security.SecurityException
Public Sub New (message As String, inner As Exception)
參數
- message
- String
解釋例外狀況原因的錯誤訊息。
- inner
- Exception
做為目前例外狀況發生原因的例外狀況。 如果 inner
參數不是 null
,則目前的例外狀況會在處理內部例外的 catch
區塊中引發。
範例
如需使用建構函式的 SecurityException 範例,請參閱針對建 SecurityException(String, Object, Object, MethodInfo, Object, IPermission) 構函式提供的範例。
備註
被擲回以做為前一個例外狀況直接結果的例外狀況,應該在 InnerException 屬性中包含對前一個例外狀況的參考。
InnerException 屬性傳回的值會與傳入建構函式的值相同,或傳回 null
(如果 InnerException 屬性未提供內部例外狀況值給建構函式)。
下表顯示 SecurityException 類別執行個體的初始屬性值。
屬性 | 值 |
---|---|
InnerException | 內部例外狀況參考。 |
Message | 當地語系化的錯誤訊息字串。 |
另請參閱
適用於
SecurityException(String, Type)
使用指定的錯誤訊息以及造成例外狀況擲回的權限類型,初始化 SecurityException 類別的新執行個體。
public:
SecurityException(System::String ^ message, Type ^ type);
public SecurityException (string? message, Type? type);
public SecurityException (string message, Type type);
new System.Security.SecurityException : string * Type -> System.Security.SecurityException
Public Sub New (message As String, type As Type)
參數
- message
- String
解釋例外狀況原因的錯誤訊息。
- type
- Type
導致擲回此例外狀況的權限類型。
範例
如需使用建構函式的 SecurityException 範例,請參閱針對建 SecurityException(String, Object, Object, MethodInfo, Object, IPermission) 構函式提供的範例。
備註
下表顯示這個建構函式所設定的屬性值。
屬性 | 值 |
---|---|
Message | 所 message 指定的當地語系化錯誤訊息字串。 |
PermissionType |
Type失敗之許可權的 ,由 type 指定。 |
適用於
SecurityException(String, Type, String)
使用指定的錯誤訊息、造成例外狀況擲回的權限類型以及權限狀態,初始化 SecurityException 類別的新執行個體。
public:
SecurityException(System::String ^ message, Type ^ type, System::String ^ state);
public SecurityException (string? message, Type? type, string? state);
public SecurityException (string message, Type type, string state);
new System.Security.SecurityException : string * Type * string -> System.Security.SecurityException
Public Sub New (message As String, type As Type, state As String)
參數
- message
- String
解釋例外狀況原因的錯誤訊息。
- type
- Type
導致擲回此例外狀況的權限類型。
- state
- String
導致擲回此例外狀況的權限狀態。
範例
如需使用建構函式的 SecurityException 範例,請參閱針對建 SecurityException(String, Object, Object, MethodInfo, Object, IPermission) 構函式提供的範例。
備註
下表顯示這個建構函式所設定的屬性值。
屬性 | 值 |
---|---|
Message | 所 message 指定的當地語系化錯誤訊息字串。 |
PermissionType |
Type失敗之許可權的 ,由 type 指定。 |
Demanded | 失敗的安全性許可權、許可權集合或許可權集合集合。 |
適用於
SecurityException(String, Object, Object, MethodInfo, Object, IPermission)
針對此堆疊上 Deny 所造成例外狀況,初始化 SecurityException 類別的新執行個體。
public:
SecurityException(System::String ^ message, System::Object ^ deny, System::Object ^ permitOnly, System::Reflection::MethodInfo ^ method, System::Object ^ demanded, System::Security::IPermission ^ permThatFailed);
public SecurityException (string message, object deny, object permitOnly, System.Reflection.MethodInfo method, object demanded, System.Security.IPermission permThatFailed);
new System.Security.SecurityException : string * obj * obj * System.Reflection.MethodInfo * obj * System.Security.IPermission -> System.Security.SecurityException
Public Sub New (message As String, deny As Object, permitOnly As Object, method As MethodInfo, demanded As Object, permThatFailed As IPermission)
參數
- message
- String
解釋例外狀況原因的錯誤訊息。
- deny
- Object
拒絕的權限或權限集。
- permitOnly
- Object
僅限允許的權限或權限集。
- method
- MethodInfo
MethodInfo,會識別發生例外狀況的方法。
- demanded
- Object
要求的使用權限、權限集或權限集集合。
- permThatFailed
- IPermission
IPermission,會識別失敗的權限。
範例
下列程式碼範例示範建構函式的使用 SecurityException(String, Object, Object, MethodInfo, Object, IPermission) 方式。
// Demonstrate the SecurityException constructor
// by throwing the exception again.
Display("Rethrowing the exception thrown as a "
"result of a PermitOnly security action.");
throw gcnew SecurityException(exception->Message,
exception->DenySetInstance,
exception->PermitOnlySetInstance,
exception->Method, exception->Demanded,
exception->FirstPermissionThatFailed);
//Demonstrate the SecurityException constructor by
// throwing the exception again.
Display("Rethrowing the exception thrown as a result of a " +
"PermitOnly security action.");
throw new SecurityException(sE.Message, sE.DenySetInstance,
sE.PermitOnlySetInstance, sE.Method, sE.Demanded,
(IPermission)sE.FirstPermissionThatFailed);
' Demonstrate the SecurityException constructor by
' throwing the exception again.
Display("Rethrowing the exception thrown as a result of a " & _
"PermitOnly security action.")
Throw New SecurityException(sE.Message, sE.DenySetInstance, _
sE.PermitOnlySetInstance, sE.Method, sE.Demanded, _
CType(sE.FirstPermissionThatFailed, IPermission))
備註
如果包含 Deny 的框架導致需求失敗,請使用這個建構函式。 下表顯示這個建構函式所設定的屬性值。
屬性 | 值 |
---|---|
Message | 所 message 指定的當地語系化錯誤訊息字串。 |
FirstPermissionThatFailed | 許可權集合或 所 permThatFailed 指定之許可權集合中的第一個許可權。 |
GrantedSet | 空字串。 |
Demanded | 所指定的 demanded 安全性許可權、許可權集合或許可權集合集合。 |
RefusedSet | 空字串。 |
DenySetInstance | 所指定的 deny 拒絕安全性許可權、許可權集合或許可權集合集合。 |
PermitOnlySetInstance | 所指定的 permitOnly 許可權、許可權集合或許可權集合集合。 |
FailedAssemblyInfo |
null . |
Method |
MethodInfo 指定的 method 。 |
Zone | NoZone. |
Url | 空字串。 |
適用於
SecurityException(String, AssemblyName, PermissionSet, PermissionSet, MethodInfo, SecurityAction, Object, IPermission, Evidence)
針對沒有足夠授權集所造成的例外狀況,初始化 SecurityException 類別的新執行個體。
public:
SecurityException(System::String ^ message, System::Reflection::AssemblyName ^ assemblyName, System::Security::PermissionSet ^ grant, System::Security::PermissionSet ^ refused, System::Reflection::MethodInfo ^ method, System::Security::Permissions::SecurityAction action, System::Object ^ demanded, System::Security::IPermission ^ permThatFailed, System::Security::Policy::Evidence ^ evidence);
public SecurityException (string message, System.Reflection.AssemblyName assemblyName, System.Security.PermissionSet grant, System.Security.PermissionSet refused, System.Reflection.MethodInfo method, System.Security.Permissions.SecurityAction action, object demanded, System.Security.IPermission permThatFailed, System.Security.Policy.Evidence evidence);
new System.Security.SecurityException : string * System.Reflection.AssemblyName * System.Security.PermissionSet * System.Security.PermissionSet * System.Reflection.MethodInfo * System.Security.Permissions.SecurityAction * obj * System.Security.IPermission * System.Security.Policy.Evidence -> System.Security.SecurityException
Public Sub New (message As String, assemblyName As AssemblyName, grant As PermissionSet, refused As PermissionSet, method As MethodInfo, action As SecurityAction, demanded As Object, permThatFailed As IPermission, evidence As Evidence)
參數
- message
- String
解釋例外狀況原因的錯誤訊息。
- assemblyName
- AssemblyName
AssemblyName,其指定造成例外狀況的組件名稱。
- grant
- PermissionSet
PermissionSet,代表授與組件的權限。
- refused
- PermissionSet
PermissionSet,代表拒絕權限或權限集。
- method
- MethodInfo
MethodInfo,代表發生例外狀況的方法。
- action
- SecurityAction
其中一個 SecurityAction 值。
- demanded
- Object
要求的使用權限、權限集或權限集集合。
- permThatFailed
- IPermission
IPermission,代表失敗的權限。
備註
當授與集造成需求失敗時,請使用這個建構函式擲回例外狀況。
下表顯示這個建構函式所設定的屬性值。
屬性 | 值 |
---|---|
Message | 指定的 message 當地語系化錯誤訊息字串。 |
FirstPermissionThatFailed | 許可權集合或 所 permThatFailed 指定許可權集合中的第一個許可權。 |
GrantedSet |
PermissionSet 指定的 grant 。 |
Demanded | 要求的安全性許可權、許可權集合或失敗的許可權集合,由 指定 demanded 。 |
RefusedSet |
PermissionSet 指定的 refused 。 |
DenySetInstance | 空字串。 |
PermitOnlySetInstance | 空字串。 |
FailedAssemblyInfo |
AssemblyName 指定的 assemblyName 。 |
Method |
MethodInfo 指定的 method 。 |
Zone |
SecurityZone所 Evidenceevidence 指定的 值。 |
Url | 所 Evidence 指定 之 的 evidence URL。 |