ConditionalAttribute Classe

Definizione

public ref class ConditionalAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Method, AllowMultiple=true)]
public sealed class ConditionalAttribute : Attribute

[System.AttributeUsage(System.AttributeTargets.Method, AllowMultiple=true)]
[System.Serializable]
public sealed class ConditionalAttribute : Attribute

[System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Method, AllowMultiple=true)]
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class ConditionalAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Method, AllowMultiple=true)>]
type ConditionalAttribute = class
    inherit Attribute

[<System.AttributeUsage(System.AttributeTargets.Method, AllowMultiple=true)>]
[<System.Serializable>]
type ConditionalAttribute = class
    inherit Attribute

[<System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Method, AllowMultiple=true)>]
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type ConditionalAttribute = class
    inherit Attribute

Public NotInheritable Class ConditionalAttribute
Inherits Attribute

Ereditarietà

Object

Attribute

ConditionalAttribute

Attributi

AttributeUsageAttribute SerializableAttribute ComVisibleAttribute

Esempio

L'esempio seguente illustra l'uso di ConditionalAttribute. Nell'esempio si presuppone che la condizione sia definita con l'opzione del compilatore /define . È possibile ottenere risultati diversi modificando l'opzione del compilatore. È possibile definire le condizioni utilizzando i pragma nel codice di esempio anziché identificarle come opzioni del compilatore.

#define CONDITION1
#define CONDITION2
using System;
using System.Diagnostics;

class Test
{
    static void Main()
    {
        Console.WriteLine("Calling Method1");
        Method1(3);
        Console.WriteLine("Calling Method2");
        Method2();

        Console.WriteLine("Using the Debug class");
        Debug.Listeners.Add(new ConsoleTraceListener());
        Debug.WriteLine("DEBUG is defined");
    }

    [Conditional("CONDITION1")]
    public static void Method1(int x)
    {
        Console.WriteLine("CONDITION1 is defined");
    }

    [Conditional("CONDITION1"), Conditional("CONDITION2")]
    public static void Method2()
    {
        Console.WriteLine("CONDITION1 or CONDITION2 is defined");
    }
}

/*
When compiled as shown, the application (named ConsoleApp)
produces the following output.

Calling Method1
CONDITION1 is defined
Calling Method2
CONDITION1 or CONDITION2 is defined
Using the Debug class
DEBUG is defined
*/

#Const CONDITION1 = True
#Const CONDITION2 = True
Imports System.Diagnostics

Class Test

    Shared Sub Main()
        Console.WriteLine("Calling Method1")
        Method1(3)
        Console.WriteLine("Calling Method2")
        Method2()
        
        Console.WriteLine("Using the Debug class")
        Debug.Listeners.Add(New ConsoleTraceListener())
        Debug.WriteLine("DEBUG is defined")
    End Sub
       
    <ConditionalAttribute("CONDITION1")> _
    Shared Sub Method1(x As Integer)
        Console.WriteLine("CONDITION1 is defined")
    End Sub
    
    <ConditionalAttribute("CONDITION1"), ConditionalAttribute("CONDITION2")> _
    Shared Sub Method2()
        Console.WriteLine("CONDITION1 or CONDITIOIN2 is defined")
    End Sub
    
End Class


' When compiled as shown, the application (named ConsoleApp) 
' produces the following output.

'Calling Method1
'CONDITION1 is defined
'Calling Method2
'CONDITION1 or CONDITION2 is defined
'Using the Debug class
'DEBUG is defined

Commenti

È possibile applicare l'attributo ConditionalAttribute a metodi e classi. Tuttavia, il relativo uso nelle classi è valido solo per i tipi derivati da Attribute. ConditionalAttribute verrà ignorato o genererà un avviso del compilatore o un messaggio di errore se lo si applica a qualsiasi altro tipo.

L'applicazione ConditionalAttribute a un metodo indica ai compilatori che una chiamata al metodo non deve essere compilata in Microsoft Intermediate Language (MSIL) a meno che non sia definito il simbolo di compilazione condizionale associato ConditionalAttribute a . Se si applica questo attributo a un metodo che non restituisce void, verrà visualizzato un errore di compilazione in Visual Studio. L'applicazione ConditionalAttribute a un attributo indica che l'attributo non deve essere generato ai metadati a meno che non sia definito il simbolo di compilazione condizionale. Gli argomenti passati al metodo o all'attributo vengono comunque controllati dal compilatore.

È possibile usare le tecniche seguenti per definire i simboli di compilazione condizionale:

• Usare le opzioni della riga di comando del compilatore; ad esempio /define:DEBUG.

• Usare le variabili di ambiente nella shell del sistema operativo; Ad esempio, impostare DEBUG=1.

• Utilizzare i pragma nel codice sorgente; ad esempio, definire una variabile di compilazione come segue:

  #define DEBUG  
  

  #Const DEBUG=True  
  

  Per annullare la definizione della variabile, utilizzare quanto segue:

  #undef DEBUG  
  

  #Const DEBUG=False  
  

I compilatori conformi a Common Language Specification (CLS) possono ignorare ConditionalAttribute. I compilatori C#, F#, Visual Basic e C++ supportano ConditionalAttribute; il compilatore JScript non supporta l'attributo .

ConditionalAttribute viene applicato ai metodi definiti nelle Debug classi e Trace .

Per altre informazioni sull'uso degli attributi, vedere Attributi.

Costruttori

Proprietà

Metodi

Implementazioni dell'interfaccia esplicita

Si applica a