.net - How exactly does the "Specific Version" property of an assembly reference work in Visual Studio? -


today had closer @ "specific version" property of assembly references in visual studio 2010. after few experiments unexpected results set out learn as possible how property works. so, appears me, not have answers, here attempt @ self-answering question:

how exactly "specific version" property of assembly reference work in visual studio?

it's compile-time property!

one of important things know "specific version" property takes effect @ compile-time , not @ runtime.

what about?

when project built, project's assembly references need resolved in order find physical assemblies build system should use. if "specific version" check performed (see section "when "specific version" checked?"), affects outcome of assembly resolution process:

  • the build system locates physical assembly can potentially use
  • the build system compares physical assembly's version assembly version stored in .csproj file assembly reference
  • if 2 assembly versions same, resolution process succeeds , physical assembly found used build
  • if 2 assembly versions not match, physical assembly discarded , resolution process continues locating next potential assembly
  • if no more potential physical assemblies can located, resolution process fails. results in compiler warning (warning msb3245) tells reference not resolved.
  • interestingly enough, the build continues! if code has no actual references assembly, build succeeds (with mentioned warning). if code has references, build fails error looks if code using unknown types or namespaces. indication why build really failed warning msb3245.

order in assemblies resolved

the order in assembly resolution process locates potential assemblies appears this:

  1. the assembly referenced <hintpath> element in .csproj file
  2. the project output path
  3. the gac

note if several versions of assembly exist in gac, resolution process first attempts resolve assembly highest version. important if "specific version" check not made.

when "specific version" checked?

visual studio bases decision whether perform "specific version" check on 2 pieces of information found in .csproj file:

  • the presence or absence of <specificversion> element, , value (if present)
  • the presence or absence of version information in assembly reference

this how typical assembly reference version information looks like:

<reference include="foo, version=1.2.3.4, culture=neutral, processorarchitecture=msil">   <specificversion>true</specificversion>   <hintpath>..\..\bar\foo.dll</hintpath> </reference>

and how assembly reference looks without version information:

<reference include="foo"> [...]

the following table shows when "specific version" check performed, , when not.

                            |     version information                             |  present       not present ----------------------------+------------------------------ <specificversion>           | - present, has value true   |    yes (1)        yes (check fails) (2) - present, has value false  |    no  (3)        no (4) - not present               |    yes (5)        no (6)

the surprising thing here no check performed if both <specificversion> , version information absent (case 6). have expected check performed , fail (same case 2) because in understanding absence of <specificversion> implies default value "true". may quirk of visual studio 2010 did tests.

when examine properties of assembly reference in visual studio ui (select reference , hit f4), value see "specific version" property tells whether or not visual studio going perform "specific version" check. in case 6 ui show "true", although <specificversion> element not present in .csproj file.

side-effects on "copy local"

if "copy local" property set "true" assembly resolution process fails because of "specific version" check, no assembly copied.

reference material


Comments

Post a Comment

Popular posts from this blog

commonjs - How to write a typescript definition file for a node module that exports a function? -

consider, toml node module can use: // toml.d.ts declare module toml { export function parse(value:string):any; } declare module "toml" { export = toml; } then: /// <reference path="../../../../../defs/toml/toml.d.ts"/> import toml = require('toml'); toml.parse(...); however, node module export single function, such 'glob' ( https://github.com/isaacs/node-glob ). the node usage of module be: var glob = require("glob") glob("*.js", {}, callback(err, files) { ... }); you'd naively expect this: // glob.d.ts declare function globs(paths:string, options:any, callback:{(err:any, files:string[]):void; ...but because typescripts 'import' semantics bit strange, seems can use 'import .. = require()' statement alias modules . trying call: /// <reference path="../../../../../defs/glob/glob.d.ts"/> import blog = require('glob'); results in: error ts2072: mod
Read more

openid - Okta: Failed to get authorization code through API call -

i'm integrating okta own idp server using okta's api. i'm implementing authorization code flow following steps below: in own server, use /api/v1/authn endpoint sessiontoken. use sessiontoken obtain authorization calling endpoint: /oauth2/v1/authorize?client_id=" + clientid + "&sessiontoken=" + sessiontoken + "&response_type=code&response_mode=query&scope=openid&redirect_uri=" + redirecturl + "&state=evanyang&nonce=" it's supposed return response status code 302 , location header containing redirect url code value. however, keep getting response status code 200 , without location header, html body saying "you using unsupported browser." , "javascript disabled on browser." according api documentation: http://developer.okta.com/docs/api/resources/oidc.html#authentication-request , sessiontoken parameter sufficient this: an okta one-time sessiontoken. allows api-based
Read more

thorough guide for profiling racket code -

did googling ("racket profiling", "racket measure performance"), didn't find , there no examples in docs. did google "profile" search on htdp - no luck. (profile (f ...)) output isn't obvious other small snippets. ideally want python's python -m cprofile usage examples. when search "python profiling", both duckduckgo , google give top result: 26.4. python profilers . (although scanned quickly, seems more of reference "thorough usage guide" examples. if had else in mind, perhaps please link that?) the equivalent racket documentation be: profile: statistical profiler . a usage example: #lang racket (require profile) (profile-thunk (thunk (function-to-profile arg0 arg1) )) here (thunk e) convenience (lambda () e) . bigger example: #lang racket (module mod racket (provide f) (define (f) (for/list ([i 10000]) i))) (require (prefix-in mod: 'mod)) (define (f) (for ([i 10000
Read more