客戶清單文件

　　一個客戶文件（程序或庫）能依靠于程序集中的某個文件來構建，但客戶文件只會依靠于程序集的某個特定版本來構建，Windows也只會加載所需的特定版本。為標出所需共享程序集的版本，一個可執行文件（程序或庫）也必須有一個清單文件（manifest）。鏈接器在可執行文件生成時，會為其創建一個包含清單信息的文件，因此，假如回過頭來看一下前面生成的庫的目錄，會找到一個名為"lib.dll.manifest"的文件，例3是其的內容。

　　例3：

＜?xml version='1.0' encoding='UTF-8' standalone='yes'?＞
＜assembly xmlns='urn:schemas-microsoft-com:asm.v1' manifestVersion='1.0'＞
＜dependency＞
＜dependentAssembly＞
＜assemblyIdentity type='win32' name='Microsoft.VC80.CRT'
version='8.0.50608.0' publicKeyToken='1fc8b3b9a1e18e3b' /＞
＜/dependentAssembly＞
＜/dependency＞
＜/assembly＞
　　正如大家所看見的，它說明托管程序集lib.dll依靠于Microsoft.VC80.CRT共享并列程序集中的某些文件。盡管這個文件位于庫lib.dll的同一目錄中，但Windows明顯不會用到它，而這與MSDN中寫明的有點背道而馳：

　?。∕SDN）：你可在應用程序二進制可執行頭文件中包含應用程序清單文件……，作為備選方案，也可把一個單獨的清單文件放在應用程序可執行文件的同一目錄中，操作系統會首先從文件系統中加載此清單文件，并檢查可執行文件的資源節。文件系統的版本具有優先權。

　　然而，完全不是這么回事。對庫而言，Windows會忽略清單文件，盡管如此，文檔還是給出了怎樣解決這個問題的一個線索，清單文件一定要以資源ID為2的非托管資源RT_MANIFEST形式綁定到可執行文件。

　　在此有兩種方法：第一種方法是創建一個包含對清單文件引用的資源腳本文件：

#include ＜winuser.h＞
2 RT_MANIFEST lib.dll.manifest
　　它會在以后通過Windows資源編譯器rc.exe編譯為一個資源，并通過鏈接器限定為一個非托管資源。這種方法的問題之處在于，是鏈接器創建了這個清單文件，因此必須運行兩次鏈接器：一次是為生成清單文件，一次是把資源鏈接到最終生成文件。例4是一個范例makefile，演示了如何進行操作：

　　例4：

# The main target
all: app.exe

# A C# process that depends upon a Managed C++ library
app.exe : app.cs lib.dll
csc app.cs /r:lib.dll
# This is the second invocation of the linker, so the object file and
# manifest will already exist, so they do not need to be rebuilt.
lib.dll : lib.cpp lib.res lib.obj
link /DLL /manifest:no /machine:x86 lib.res lib.obj
lib.res : lib.rc
rc lib.rc
# Create a temporary resource script that binds the manifest file to the DLL
lib.rc : lib.dll.manifest
type ＜＜$@
#include ＜winuser.h＞
2 RT_MANIFEST lib.dll.manifest
＜＜KEEP
# Create the object file, and invoke the linker to create the manifest file
lib.dll.manifest lib.obj : lib.cpp
cl /LD /clr lib.cpp
　　另一個方法是使用mt.exe未公開的隱藏選項把資源綁定到最終生成文件上，這也是Visual Studio 2005創建加載的C++庫（托管混合模式或非托管模式）時所使用的方法。兩個隱藏選項分別為/manifest和/outputresource：前者用于指定清單文件名，而后者用于指出將要修改的PE文件及清單資源的資源ID。一般而言，對庫來說，資源ID應為2；對程序來說，應為1。請看以下示例：

mt /manifest lib.dll.manifest
/outputresource:lib.dll;#2

　　注重此處的區別：/manifest選項后跟的參數是用空格分隔的；而/outputresource選項后跟的參數是用冒號分隔的。明顯看得出，這兩個選項是由不同的程序員開發的。

　　一旦你把清單文章綁定到庫，Windows就可以判定需加載程序集的正確版本。假如在作出這些修改之后，運行前面的C#程序，也會發現程序運行正常。

　　假如你生成了一個混合模式（/clr）或純媒介語言模式（/clr:pure）的托管C++程序，來使用這個混合模式的庫，鏈接器也創建了一個相應的程序清單文件，當此程序運行時，Windows會查找資源ID為1的清單文件，或查找名為manifest的相應文件。因為混合模式或純媒介語言模式程序都用到了CRT，意味著將會在清單文件中提及CRT程序集，所以，在這個特例中，庫不需要清單文件。然而，你不應該依靠這個機制，因為在本例中，程序使用同一個非托管程序集作為庫是一個偶然情況。進入討論組討論。