Partilhar via


/Reference ( Opçõesdo compilador de C#)

O /reference opção faz com que o compilador importar pública digitar informações no arquivo especificado no projeto atual, permitindo que você faça referência a metadados dos arquivos de assembly especificado.

/reference:[alias=]filename
/reference:filename

Argumentos

  • filename
    O nome de um arquivo que contém um manifesto de conjunto de módulos (assembly). Para importar mais de um arquivo, inclua um separado /reference opção para cada arquivo.

  • alias
    Um C# identificador válido que representará um namespace de raiz que conterá todos os namespaces no assembly.

Comentários

Para importar mais de um arquivo, inclua uma /reference opção para cada arquivo.

Os arquivos que você importar devem conter um manifesto; o arquivo de saída deve foram compilado com um a /target opções diferentes de /target:module.

/ré a forma abreviada de /reference.

Use /addmodule para importar metadados de um arquivo de saída que não contenha um manifesto do assembly.

Se você referencia um assembly (um Assembly) que faz referência a outro conjunto (Assembly B), você precisará referência Assembly B se:

  • Um tipo de a que usar o Assembly herda a partir de um tipo ou implementa uma interface de b de Assembly.

  • Você chamar um campo, propriedade, evento ou método que possui um tipo de retorno ou parâmetro de b de Assembly.

Use /lib para especificar o diretório no qual uma ou mais das suas referências de assembly estão localizado. O /lib tópico também descreve os diretórios nos quais o compilador procura assemblies.

Para o compilador reconhecer um tipo em um assembly e não em um módulo, ele precisa ser forçado a resolver o tipo, o que pode ser feito definindo uma instância do tipo. Existem outras maneiras de resolver nomes de tipo em um assembly para o compilador: Por exemplo, se você herdar de um tipo em um assembly, o nome do tipo, em seguida, será reconhecido pelo compilador.

Às vezes é necessário fazer referência a duas versões diferentes do mesmo componente de um assembly. Para fazer isso, use o suboption de alias a /reference switch para cada arquivo distinguir entre os dois arquivos. Esse alias será usado como um qualificador para o nome do componente e resolverá para o componente em um dos arquivos.

O arquivo de resposta (.rsp) csc, quais referências usadas.NET assemblies do Framework, que é usado por padrão. Use /noconfig se não quiser que o compilador para usar o csc.rsp.

ObservaçãoObservação

No Visual Studio, use o Add Reference caixa de diálogo. Para obter mais informações, consulte Como: Adicionar ou remover referências no Visual Studio. Em 2010 de Visual Studio e versões posteriores, para garantir o comportamento equivalente entre Adicionando referências usando /reference e usando o Add Reference caixa de diálogo, o Incorporar tipos de interoperabilidade propriedade deve ser definida False para o assembly que você está adicionando. True é o valor padrão para essa propriedade.

Exemplo

Este exemplo mostra como usar o alias externo recurso.

Compilar o arquivo de origem e importar os metadados de grid.dll e grid20.dll,que foram compilados anteriormente. As duas DLLs contêm versões diferentes do mesmo componente, e usa dois /reference com as opções de alias para compilar o arquivo de origem. As opções tem esta aparência:

/Reference:GridV1=Grid.dll e /reference:GridV2=grid20.dll

Isso configura os alias externos "gridv1" e "gridv2", que você usar no seu programa por meio de uma instrução extern:

extern alias GridV1;
extern alias GridV2;
// Using statements go here.

Feito isso, você pode consultar o controle de grade de grid.dll por prefixando o nome do controle com GridV1, como este:

GridV1::Grid

Além disso, você pode consultar o controle de grade de grid20.dll por prefixando o nome do controle com GridV2 como este:

GridV2::Grid 

Consulte também

Outros recursos

C# Compiler Options

Propriedades de Projeto (Visual Studio)