AllowPartiallyTrustedCallersAttribute Klasa

Definicja

Przestrzeń nazw:

System.Security

Zestawy:

netstandard.dll, System.Runtime.dll

Źródło:

AllowPartiallyTrustedCallersAttribute.cs

Umożliwia wywoływanie zestawu przez częściowo zaufany kod. Bez tej deklaracji tylko w pełni zaufane osoby wywołujące mogą używać zestawu. Tej klasy nie można dziedziczyć.

C#

[System.AttributeUsage(System.AttributeTargets.Assembly, AllowMultiple=false, Inherited=false)]
public sealed class AllowPartiallyTrustedCallersAttribute : Attribute

Dziedziczenie

Object

Attribute

AllowPartiallyTrustedCallersAttribute

Atrybuty

AttributeUsageAttribute

Przykłady

W poniższym przykładzie pokazano, jak używać klasy AllowPartiallyTrustedCallersAttribute.

C#

// The following HTML code can be used to call the user control in this sample.
//
//		<OBJECT id="usercontrol" classid="usercontrol.dll#UserControl.UserControl1" width="800"
//		height="300" style="font-size:12;">

// To run this test control you must create a strong name key, snkey.snk, and 
// a code group that gives full trust to assemblies signed with snkey.snk.

// The user control displays an OpenFileDialog box, then displays a text box containing the name of 
// the file selected and a list box that displays the contents of the file.  The selected file must 
// contain text in order for the control to display the data properly.

// Caution  This sample demonstrates the use of the Assert method.  Calling Assert removes the 
// requirement that all code in the call chain must be granted permission to access the specified 
// resource, it can open up security vulnerabilities if used incorrectly or inappropriately. Therefore, 
// it should be used with great caution.  Assert should always be followed with a RevertAssert 
// command to restore the security settings.

using System;
using System.Collections;
using System.ComponentModel;
using System.Drawing;
using System.Data;
using System.Windows.Forms;
using System.IO;
using System.Security;
using System.Security.Permissions;
using System.Reflection;
using System.Runtime.CompilerServices;

// This strong name key is used to create a code group that gives permissions to this assembly.
[assembly: AssemblyKeyFile("snKey.snk")]
[assembly: AssemblyVersion("1.0.0.0")]

// The AllowPartiallyTrustedCallersAttribute requires the assembly to be signed with a strong name key.
// This attribute is necessary since the control is called by either an intranet or Internet
// Web page that should be running under restricted permissions.
[assembly:AllowPartiallyTrustedCallers]
namespace UserControl
{
    // The userControl1 displays an OpenFileDialog box, then displays a text box containing the name of 
    // the file selected and a list box that displays the contents of the file.  The selected file must 
    // contain text in order for the control to display the data properly.
    public class UserControl1 : System.Windows.Forms.UserControl
    {
        private System.Windows.Forms.TextBox textBox1;
        private System.Windows.Forms.ListBox listBox1;
        // Required designer variable.
        private System.ComponentModel.Container components = null;

              // Demand the zone requirement for the calling application.
              [ZoneIdentityPermission(SecurityAction.Demand, Zone = SecurityZone.Intranet)]
        public UserControl1()
        {
            // This call is required by the Windows.Forms Form Designer.
            InitializeComponent();

            // The OpenFileDialog box should not require any special permissions.
            OpenFileDialog fileDialog = new OpenFileDialog();
            if(fileDialog.ShowDialog() == DialogResult.OK)
            {
                // Reading the name of the selected file from the OpenFileDialog box
                // and reading the file requires FileIOPermission.  The user control should 
                // have this permission granted through its code group; the Web page that calls the 
                // control should not have this permission.  The Assert command prevents a stack walk 
                // that would fail because the caller does not have the required FileIOPermission.  
                // The use of Assert can open up security vulnerabilities if used incorrectly or 
                // inappropriately. Therefore, it should be used with great caution.
                // The Assert command should be followed by a RevertAssert as soon as the file operation 
                // is completed.
                new FileIOPermission(PermissionState.Unrestricted).Assert();
                textBox1.Text = fileDialog.FileName;
                // Display the contents of the file in the text box.
                FileStream fsIn = new FileStream(textBox1.Text, FileMode.Open, FileAccess.Read, 
                    FileShare.Read);
                StreamReader sr = new StreamReader(fsIn);
            
                // Process every line in the file
                for (String Line = sr.ReadLine(); Line != null; Line = sr.ReadLine()) 
                {
                    listBox1.Items.Add(Line);
                }
                // It is very important to call RevertAssert to restore the stack walk for
                // file operations.
                FileIOPermission.RevertAssert();
            }
        }

        // Clean up any resources being used.
        protected override void Dispose( bool disposing )
        {
            if( disposing )
            {
                if( components != null )
                    components.Dispose();
            }
            base.Dispose( disposing );
        }

        #region Component Designer generated code
        /// <summary>
        /// Required method for Designer support - do not modify 
        /// the contents of this method with the code editor.
        /// </summary>
        private void InitializeComponent()
        {
            this.textBox1 = new System.Windows.Forms.TextBox();
            this.listBox1 = new System.Windows.Forms.ListBox();
            this.SuspendLayout();
            // 
            // textBox1
            // 
            this.textBox1.Location = new System.Drawing.Point(208, 112);
            this.textBox1.Name = "textBox1";
            this.textBox1.Size = new System.Drawing.Size(320, 20);
            this.textBox1.TabIndex = 0;
            this.textBox1.Text = "textBox1";
            this.textBox1.TextChanged += new System.EventHandler(this.textBox1_TextChanged);
            // 
            // listBox1
            // 
            this.listBox1.Location = new System.Drawing.Point(200, 184);
            this.listBox1.Name = "listBox1";
            this.listBox1.Size = new System.Drawing.Size(336, 108);
            this.listBox1.TabIndex = 1;
            // 
            // UserControl1
            // 
            this.Controls.Add(this.listBox1);
            this.Controls.Add(this.textBox1);
            this.Name = "UserControl1";
            this.Size = new System.Drawing.Size(592, 400);
            this.Load += new System.EventHandler(this.UserControl1_Load);
            this.ResumeLayout(false);
        }
        #endregion

        private void UserControl1_Load(object sender, System.EventArgs e)
        {
        }

        private void textBox1_TextChanged(object sender, System.EventArgs e)
        {
        }
    }
}

Uwagi

Ważne

Częściowo zaufany kod nie jest już obsługiwany. Ten atrybut nie ma wpływu na platformę .NET Core.

Uwaga

Program .NET Framework 4 wprowadza nowe reguły zabezpieczeń, które wpływają na zachowanie atrybutu AllowPartiallyTrustedCallersAttribute (zobacz kod Security-Transparent, poziom 2). W programie .NET Framework 4 wszystkie kody są domyślnie niewidoczne dla zabezpieczeń, czyli częściowo zaufane. Można jednak dodawać adnotacje do poszczególnych typów i elementów członkowskich, aby przypisywać im inne atrybuty przezroczystości. W przypadku tych i innych zmian zabezpieczeń zobacz Zmiany zabezpieczeń.

Zestawy programu .NET Framework w wersji 2.0 () muszą mieć silną nazwę, aby efektywnie używać atrybutu AllowPartiallyTrustedCallersAttribute (APTCA). Zestawy programu .NET Framework 4 () nie muszą mieć silnej nazwy, aby atrybut APTCA był skuteczny i może zawierać przezroczysty, krytyczny dla zabezpieczeń i bezpieczny kod krytyczny dla zabezpieczeń. Aby uzyskać więcej informacji na temat stosowania atrybutów na poziomie zestawu, zobacz Stosowanie atrybutów.

Domyślnie, jeśli zestaw o silnej nazwie nie stosuje jawnie tego atrybutu na poziomie zestawu, może być wywoływany tylko przez inne zestawy, które mają pełne zaufanie. To ograniczenie jest wymuszane przez umieszczenie LinkDemand dla FullTrust dla każdej publicznej lub chronionej metody w każdej publicznie dostępnej klasie w zestawie. Zestawy, które mają być wywoływane przez częściowo zaufany kod, mogą zadeklarować ich intencję za pomocą AllowPartiallyTrustedCallersAttribute. Przykładem deklaracji w języku C# jest [assembly:AllowPartiallyTrustedCallers]; przykładem w języku Visual Basic jest <assembly:AllowPartiallyTrustedCallers>.

Przestroga

Obecność tego atrybutu na poziomie zestawu uniemożliwia domyślne zachowanie umieszczania FullTrustLinkDemand kontroli zabezpieczeń i sprawia, że zestaw jest wywoływany z dowolnego innego (częściowo lub w pełni zaufanego) zestawu.

Gdy atrybut APTCA jest obecny, wszystkie inne kontrole zabezpieczeń działają zgodnie z oczekiwaniami, w tym wszelkie atrybuty zabezpieczeń na poziomie klasy lub metody deklaratywne, które są obecne. Ten atrybut blokuje tylko niejawne, w pełni zaufane żądanie wywołujące.

Nie jest to atrybut zabezpieczeń deklaratywnych, ale zwykły atrybut (pochodzi z System.Attribute, a nie z System.Security.Permissions.SecurityAttribute).

Aby uzyskać więcej informacji, zobacz Using Libraries from Partially Trusted Code.

Konstruktory

AllowPartiallyTrustedCallersAttribute()

Inicjuje nowe wystąpienie klasy AllowPartiallyTrustedCallersAttribute.

Właściwości

PartialTrustVisibilityLevel	Pobiera lub ustawia domyślną częściową widoczność zaufania dla kodu oznaczonego atrybutem AllowPartiallyTrustedCallersAttribute (APTCA).
TypeId	Po zaimplementowaniu w klasie pochodnej pobiera unikatowy identyfikator dla tego Attribute. (Odziedziczone po Attribute)

Metody

Equals(Object)	Zwraca wartość wskazującą, czy to wystąpienie jest równe określonemu obiektowi. (Odziedziczone po Attribute)
GetHashCode()	Zwraca kod skrótu dla tego wystąpienia. (Odziedziczone po Attribute)
GetType()	Pobiera Type bieżącego wystąpienia. (Odziedziczone po Object)
IsDefaultAttribute()	Po zastąpieniu w klasie pochodnej wskazuje, czy wartość tego wystąpienia jest wartością domyślną dla klasy pochodnej. (Odziedziczone po Attribute)
Match(Object)	Po zastąpieniu w klasie pochodnej zwraca wartość wskazującą, czy to wystąpienie jest równe określonemu obiektowi. (Odziedziczone po Attribute)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Object. (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Dotyczy