United States (English)

Home Library Learn Samples Downloads Support Community Forums

MSDN Library

Development Tools and Languages

Visual Studio 2012

Application Development in Visual Studio

Quality and Diagnostic Tools

Analyzing Application Quality

Analyzing Managed Code Quality

Code Analysis for Managed Code Warnings

Design Warnings

CA1000: Do not declare static members on generic types

CA1001: Types that own disposable fields should be disposable

CA1002: Do not expose generic lists

CA1003: Use generic event handler instances

CA1004: Generic methods should provide type parameter

CA1005: Avoid excessive parameters on generic types

CA1006: Do not nest generic types in member signatures

CA1007: Use generics where appropriate

CA1008: Enums should have zero value

CA1009: Declare event handlers correctly

CA1010: Collections should implement generic interface

CA1011: Consider passing base types as parameters

CA1012: Abstract types should not have constructors

CA1013: Overload operator equals on overloading add and subtract

CA1014: Mark assemblies with CLSCompliantAttribute

CA1016: Mark assemblies with AssemblyVersionAttribute

CA1017: Mark assemblies with ComVisibleAttribute

CA1018: Mark attributes with AttributeUsageAttribute

CA1019: Define accessors for attribute arguments

CA1020: Avoid namespaces with few types

CA1021: Avoid out parameters

CA1023: Indexers should not be multidimensional

CA1024: Use properties where appropriate

CA1025: Replace repetitive arguments with params array

CA1026: Default parameters should not be used

CA1027: Mark enums with FlagsAttribute

CA1028: Enum storage should be Int32

CA1030: Use events where appropriate

CA1031: Do not catch general exception types

CA1032: Implement standard exception constructors

CA1033: Interface methods should be callable by child types

CA1034: Nested types should not be visible

CA1035: ICollection implementations have strongly typed members

CA1036: Override methods on comparable types

CA1038: Enumerators should be strongly typed

CA1039: Lists are strongly typed

CA1040: Avoid empty interfaces

CA1041: Provide ObsoleteAttribute message

CA1043: Use integral or string argument for indexers

CA1044: Properties should not be write only

CA1045: Do not pass types by reference

CA1046: Do not overload operator equals on reference types

CA1047: Do not declare protected members in sealed types

CA1048: Do not declare virtual members in sealed types

CA1049: Types that own native resources should be disposable

CA1050: Declare types in namespaces

CA1051: Do not declare visible instance fields

CA1052: Static holder types should be sealed

CA1053: Static holder types should not have constructors

CA1054: URI parameters should not be strings

CA1055: URI return values should not be strings

CA1056: URI properties should not be strings

CA1057: String URI overloads call System.Uri overloads

CA1058: Types should not extend certain base types

CA1059: Members should not expose certain concrete types

CA1060: Move P/Invokes to NativeMethods class

CA1061: Do not hide base class methods

CA1062: Validate arguments of public methods

CA1063: Implement IDisposable correctly

CA1064: Exceptions should be public

CA1065: Do not raise exceptions in unexpected locations

CA2210: Assemblies should have valid strong names

Minimize

This topic has not yet been rated - Rate this topic

CA1017: Mark assemblies with ComVisibleAttribute

Visual Studio 2012

TypeName	MarkAssembliesWithComVisible
CheckId	CA1017
Category	Microsoft.Design
Breaking Change	Non-breaking

An assembly does not have the System.Runtime.InteropServices.ComVisibleAttribute attribute applied to it.

Rule Description

The ComVisibleAttribute attribute determines how COM clients access managed code. Good design dictates that assemblies explicitly indicate COM visibility. COM visibility can be set for a whole assembly and then overridden for individual types and type members. If the attribute is not present, the contents of the assembly are visible to COM clients.

How to Fix Violations

To fix a violation of this rule, add the attribute to the assembly. If you do not want the assembly to be visible to COM clients, apply the attribute and set its value to false.

When to Suppress Warnings

Do not suppress a warning from this rule. If you want the assembly to be visible, apply the attribute and set its value to true.

The following example shows an assembly that has the ComVisibleAttribute attribute applied to prevent it from being visible to COM clients.

using System;

[assembly: System.Runtime.InteropServices.ComVisible(false)]
namespace DesignLibrary {}

Concepts

Qualifying .NET Types for Interoperation

Other Resources

Interoperating with Unmanaged Code

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)

© 2013 Microsoft. All rights reserved.