Mengelola referensi dalam sebuah proyek

  • Artikel
  • 5 menit untuk membaca

Berlaku untuk:yes Visual Studio noVisual Studio untuk Mac noVisual Studio Code

Sebelum Anda menulis kode terhadap komponen eksternal atau layanan terhubung, proyek Anda harus terlebih dahulu berisi referensi ke dalamnya. Referensi pada dasarnya adalah entri dalam file proyek yang berisi informasi yang dibutuhkan Visual Studio untuk menemukan komponen atau layanan.

Untuk menambahkan referensi, klik kanan pada node Referensi atau Dependensi di Penjelajah Solusi dan pilih Tambahkan Referensi. Anda juga dapat mengklik kanan pada simpul proyek dan memilih Tambahkan>Referensi. Untuk informasi selengkapnya, lihat Cara: Menambahkan atau menghapus referensi.

Add a reference in Visual C++

Anda dapat menambahkan referensi ke jenis komponen dan layanan berikut:

  • Pustaka atau rakitan kelas .NET

  • Aplikasi UWP

  • Komponen COM

  • Rakitan atau pustaka kelas proyek lainnya dalam solusi yang sama

  • Proyek bersama

  • Layanan Web XML

Referensi aplikasi UWP

Referensi project

Proyek Universal Windows Platform (UWP) dapat membuat referensi ke proyek UWP lain dalam solusi, atau ke proyek atau biner Windows 8.1, asalkan proyek-proyek ini tidak menggunakan API yang tidak digunakan lagi di Windows 10 dan yang lebih baru. Untuk informasi selengkapnya, lihat Berpindah dari Windows Runtime 8 ke UWP.

Jika Anda memilih untuk menargetkan ulang proyek Windows 8.1 ke Windows 10 dan yang lebih baru, lihat Proyek Port, migrasi, dan peningkatan Visual Studio.

Referensi SDK ekstensi

Aplikasi Visual Basic, C#, C++ dan JavaScript Universal Windows Platform (UWP) dapat mereferensikan SDK Ekstensi yang menargetkan Windows 8.1, selama SDK Ekstensi ini tidak menggunakan API yang tidak digunakan lagi di Windows 10 dan yang lebih baru. Silakan periksa situs vendor SDK Ekstensi untuk mengetahui apakah situs tersebut dapat dirujuk oleh aplikasi UWP.

Jika Anda menentukan bahwa SDK Ekstensi yang dirujuk oleh aplikasi Anda tidak didukung, Maka Anda perlu melakukan langkah-langkah berikut:

  1. Lihatlah nama proyek yang menyebabkan kesalahan. Platform yang ditargetkan proyek Anda dicatat dalam tanda kurung di samping nama proyek. Misalnya, MyProjectName (Windows 8.1) berarti bahwa proyek MyProjectName Anda menargetkan versi platform Windows 8.1.

  2. Buka situs vendor yang memiliki SDK Ekstensi yang tidak didukung, dan instal versi SDK Ekstensi dengan dependensi yang kompatibel dengan versi platform yang ditargetkan proyek Anda.

    Catatan

    Salah satu cara untuk mengetahui apakah Extension SDK memiliki dependensi pada SDK Ekstensi lainnya adalah dengan melihat di Reference Manager. Mulai ulang Visual Studio, buat proyek aplikasi C# UWP baru, lalu klik kanan proyek dan pilih Tambahkan Referensi. Buka tab Windows , lalu sub-tab Ekstensi , dan pilih SDK Ekstensi. Lihat panel kanan di Pengelola Referensi. Jika memiliki dependensi, mereka akan terdaftar di sana.

    Penting

    Jika proyek Anda menargetkan Windows 10 secara khusus, dan SDK Ekstensi yang diinstal pada langkah sebelumnya memiliki dependensi pada Paket Runtime Microsoft Visual C++, versi Paket Runtime Microsoft Visual C++ yang kompatibel dengan Windows 10 adalah v14.0, dan diinstal dengan Visual Studio.

  3. Jika SDK Ekstensi yang Anda instal di langkah sebelumnya memiliki dependensi pada SDK Ekstensi lainnya, buka situs vendor yang memiliki dependensi, dan instal versi dependensi ini yang kompatibel dengan versi platform yang ditargetkan proyek Anda.

  4. Mulai ulang Visual Studio dan buka aplikasi Anda.

  5. Klik kanan pada node Referensi atau Dependensi dalam proyek yang menyebabkan kesalahan dan pilih Tambahkan Referensi.

  6. Klik tab Windows lalu sub-tab Ekstensi , lalu hapus centang pada kotak centang untuk SDK Ekstensi lama, dan centang kotak centang untuk SDK Ekstensi baru. Klik OK.

Menambahkan referensi pada waktu desain

Saat Anda membuat referensi ke perakitan di proyek Anda, Visual Studio mencari perakitan di lokasi berikut:

  • Direktori proyek saat ini. (Anda dapat menemukan rakitan ini dengan menggunakan tab Telusuri .)

  • Direktori proyek lain dalam solusi yang sama. (Anda dapat menemukan rakitan ini pada tab Proyek .)

Catatan

  • Semua proyek berisi referensi tersirat ke mscorlib.
  • Semua proyek berisi referensi tersirat ke System.Core, bahkan jika System.Core dihapus dari daftar referensi.
  • Proyek Visual Basic berisi referensi tersirat ke Microsoft.VisualBasic.

Referensi ke komponen bersama pada durasi

Pada durasi, komponen harus berada di jalur output proyek atau di Global Assembly Cache (GAC). Jika proyek berisi referensi ke objek yang tidak berada di salah satu lokasi ini, Anda harus menyalin referensi ke jalur output proyek saat anda membangun proyek. Properti CopyLocal menunjukkan apakah salinan ini harus dibuat. Jika nilainya True, referensi disalin ke direktori proyek saat Anda membangun proyek. Jika nilainya False, referensi tidak disalin.

Jika Anda menyebarkan aplikasi yang berisi referensi ke komponen kustom yang terdaftar di GAC, komponen tidak akan disebarkan dengan aplikasi, terlepas dari pengaturannya CopyLocal . Di versi Visual Studio yang lebih lama, Anda dapat mengatur CopyLocal properti pada referensi untuk memastikan bahwa perakitan disebarkan. Sekarang, Anda harus menambahkan rakitan secara manual ke folder \Bin. Ini menempatkan semua kode kustom di bawah pengamatan, mengurangi risiko penerbitan kode kustom yang tidak Anda kenal.

Secara default, CopyLocal properti diatur ke False jika rakitan atau komponen berada di cache perakitan global atau merupakan komponen kerangka kerja. Jika tidak, nilai diatur ke True. Referensi proyek-ke-proyek selalu diatur ke True.

Mereferensikan proyek atau rakitan yang menargetkan versi .NET yang berbeda

Anda dapat membuat aplikasi yang mereferensikan proyek atau rakitan yang menargetkan versi .NET yang berbeda. Misalnya, Anda dapat membuat aplikasi yang menargetkan .NET Framework 4.6, yang mereferensikan rakitan yang menargetkan .NET Framework 4.5. Jika Anda membuat proyek yang menargetkan versi .NET yang lebih lama, Anda tidak dapat mengatur referensi dalam proyek tersebut ke proyek atau perakitan yang menargetkan versi yang lebih baru.

Untuk informasi selengkapnya, lihat Gambaran umum penargetan kerangka kerja.

Project referensi ke proyek

Referensi proyek-ke-proyek adalah referensi ke proyek yang berisi rakitan; Anda menambahkan referensi proyek dengan menggunakan tab Proyek dari kotak dialog Manajer Referensi. Visual Studio dapat menemukan assembly saat diberi jalur ke proyek.

Ketika Anda memiliki proyek yang menghasilkan assembly, Anda harus mereferensikan proyek dan tidak menggunakan referensi file (lihat di bawah). Keuntungan dari referensi proyek-ke-proyek adalah menciptakan dependensi antara proyek dalam sistem build. Proyek dependen akan dibangun jika telah berubah sejak terakhir kali proyek referensi dibangun. Referensi file tidak membuat dependensi build, sehingga dimungkinkan untuk membangun proyek referensi tanpa membangun proyek dependen, dan referensi dapat menjadi usang. (Artinya, proyek dapat mereferensikan versi proyek yang dibuat sebelumnya.) Ini dapat mengakibatkan beberapa versi DLL tunggal diperlukan dalam direktori bin , yang tidak dimungkinkan. Ketika konflik ini terjadi, Anda akan melihat pesan seperti "Peringatan: dependensi 'file' dalam proyek 'proyek' tidak dapat disalin ke direktori yang dijalankan karena akan menimpa referensi 'file.'". Untuk informasi selengkapnya, lihat Memecahkan masalah referensi yang rusak dan Cara: Membuat dan menghapus dependensi proyek.

Catatan

Referensi file alih-alih referensi proyek-ke-proyek dibuat jika versi target dari .NET Framework dari satu proyek adalah versi 4.5, dan versi target proyek lain adalah versi 2, 3, 3.5, atau 4.0.

Referensi proyek bersama

Tidak seperti kebanyakan jenis proyek lainnya, proyek bersama tidak memiliki output biner. Sebaliknya, kode dikompilasi ke dalam setiap proyek yang mereferensikannya. Proyek Bersama memungkinkan Anda menulis kode umum yang dirujuk oleh sejumlah proyek aplikasi yang berbeda. Kode ini dikompilasi sebagai bagian dari setiap proyek referensi dan dapat menyertakan arahan kompilator untuk membantu menggabungkan fungsionalitas khusus platform ke dalam basis kode bersama. Tambahkan referensi ke proyek bersama pada tab Proyek Bersama dari kotak dialog Manajer Referensi.

Referensi file

Referensi file adalah referensi langsung ke rakitan di luar konteks proyek Visual Studio. Anda membuatnya dengan menggunakan tab Telusuri dari kotak dialog Manajer Referensi. Gunakan referensi file saat Anda hanya memiliki assembly atau komponen, dan bukan proyek yang membuatnya sebagai output.

Lihat juga