ECMA TR 84-2012 Common Language Infrastructure (CLI) Technical Report Information Derived From Partition IV XML File (6th Edition).pdf

1、 Reference number ECMA TR/12:2009 Ecma International 2009 ECMA TR/84 6th Edition / June 2012 Common Language Infrastructure (CLI) Technical Report: Information Derived From Partition IV XML File COPYRIGHT PROTECTED DOCUMENT Ecma International 2012 Ecma International 2012 iii This Ecma Technical Repo

2、rt has been adopted by the General Assembly of June 2012. “COPYRIGHT NOTICE 2012 Ecma International This document may be copied, published and distributed to others, and certain derivative works of it may be prepared, copied, published, and distributed, in whole or in part, provided that the above c

3、opyright notice and this Copyright License and Disclaimer are included on all such copies and derivative works. The only derivative works that are permissible under this Copyright License and Disclaimer are: (i) works which incorporate all or portion of this document for the purpose of providing com

4、mentary or explanation (such as an annotated version of the document), (ii) works which incorporate all or portion of this document for the purpose of incorporating features that provide accessibility, (iii) translations of this document into languages other than English and into different formats a

5、nd (iv) works by making use of this specification in standard conformant products by implementing (e.g. by copy and paste wholly or partly) the functionality therein. However, the content of this document itself may not be modified in any way, including by removing the copyright notice or references

6、 to Ecma International, except as required to translate it into languages other than English or into a different format. The official version of an Ecma International document is the English language version on the Ecma International website. In the event of discrepancies between a translated versio

7、n and the official version, the official version shall govern. The limited permissions granted above are perpetual and will not be revoked by Ecma International or its successors or assigns. This document and the information contained herein is provided on an “AS IS“ basis and ECMA INTERNATIONAL DIS

8、CLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT INFRINGE ANY OWNERSHIP RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.“ iv Ecma International 2012 Ecma International 2012 1 T

9、his Technical Report is intended as an aid for understanding the libraries specified in Standard ECMA-335, Partition IV: Profiles and Libraries. This sixth edition cancels and replaces the fifth edition which has been technically revised. This Technical Report is fully aligned with ISO/IEC TR 23272:

10、2011. That Partition includes a machine-readable specification, in XML, of the types that comprise the standard libraries. This Technical Report, in companion files, provides the following items which help to form a traceable chain from the normative XML specification to a portable, printable repres

11、entation of its contents: 1. Tool Source Code: A program written in the C# programming language, XML Style-sheet Language (XSL), and using the facilities of the Microsoft .NET Framework and Microsoft Office to convert the XML into files viewable using Microsoft Word. This program, initially provided

12、 by Intel Corporation and updated by the CLI editor for this edition, can be modified to produce other views of the XML. 2. Microsoft Word Files : These are the files produced by running the tool mentioned above on the XML from Partition IV. The Ecma task group TC49/TG3 used similar files (produced

13、using earlier versions of this tool run against earlier versions of the XML) as the primary means of reviewing the XML. 3. PDF Files : These files are produced from the Microsoft Word files using the Adobe Acrobat program. They are viewable on a wide range of computer systems and printable on a rang

14、e of computer output devices. In most cases, they will appear visually identical regardless of the means used to render them. Partition IV normatively specifies the format of the XML file. The tool provided here renders all parts of the XML with exceptions for some XML nodes, as described below. For

15、 the purpose of description, XML nodes referred to here are specified in XPath notation relative to Type nodes. Name (this is redundant and unnecessary since the FullName of the type is rendered) FullNameSP (this is redundant and unnecessary since the FullName of the type is rendered) AssemblyInfo/A

16、ssemblyCulture (this is reserved for future use; currently its value is “none”) AssemblyInfo/Attributes/Attribute/Excluded (if its value is 0, it is not rendered, but if it is 1, the library that is necessary for inclusion is listed) TypeExcluded (as above) Interfaces/Interface/Excluded (as above) A

17、ttributes/Attribute/Excluded (as above) Attributes/Attribute/ExcludedTypeName (the short Name is rendered, however) Members/Member/ReturnValue/ReturnType (the FullName of the type of the return value is not specified, but it is implied via the members signature) Members/Member/Parameters/Parameter/T

18、ype (the FullName of the type of the parameter is not specified, but it is implied via the members signature) The “value_“ field for enums. Member/Member/Docs/altcompliant (used on methods/properties that have a CLSCompliant(false) attribute tag, and specifies a CLS-compliant method/property that ca

19、n be use as an alternative. The remarks/description section usually specifies this anyway). Member/Member/Docs/altmember (used on methods/properties that have equivalent alternatives that may be used. For example, the System.String op_equality operator has the altmember element and specifies the String.Equals() method as an equivalent alternative. The remarks/description section usually specifies this anyway). Ecma International 2012