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

Nell'esempio seguente viene illustrato 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. Facoltativamente, è possibile definire le condizioni usando pragmas 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, l'uso delle 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 di ConditionalAttribute a un metodo indica ai compilatori che una chiamata al metodo non deve essere compilata in Microsoft linguaggio intermedio (MSIL) a meno che non venga definito il simbolo di compilazione condizionale associato a ConditionalAttribute. 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. Tutti 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.

• Usare pragmas nel codice sorgente; Ad esempio, definire la variabile di compilazione come indicato di seguito:

  #define DEBUG
  

  #Const DEBUG=True
  

  Per annullare la definizione della variabile, usare 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 su come usare gli attributi, vedere Attributi.