zoukankan      html  css  js  c++  java
  • code 代码分析 及其解决方案

    官网地址:http://msdn.microsoft.com/zh-cn/library/ms182135.aspx

     

    [FxCop.设计规则]11. 不应该使用默认参数  

    参考地址:http://blog.csdn.net/cajon/article/details/394510  

    11.     不应该使用默认参数

    翻译概述:

    MSDN中对于调用使用默认参数的函数的说明如下:

    .NET Framework 开发员指南

     

    访问默认参数值

    某些语言(如 C++ 托管扩展和 Microsoft Visual Basic .NET)支持将默认值赋给参数。例如,以下示例是一个合法的 Visual Basic .NET 声明,此声明将默认值赋给两个参数。

    [Visual Basic]

    Public Sub MyMethod (a as Integer, _

                         Optional b as Double = 1.2, _

                         Optional c as Integer=1)

    您可以使用参数属性来分配默认的参数值。

    通过确切指定哪些参数是默认值或略去尾部的默认参数,可以声明参数的默认值。例如,以下所有示例都是对MyMethod 的有效调用。

    [Visual Basic]

    MyMethod(10, 55.3, 12)

    MyMethod(10, 1.3) ' c == 1

    MyMethod(11) ' b == 1.2, c == 1

    [C#]

    MyMethod (10, 55.3, 12);

    MyMethod (10, 1.3); // c == 1

    MyMethod (11); // b == 1.2, c == 1

    要使用反射检索参数的默认值,请获取该参数的 ParameterInfo 对象,然后使用 ParameterInfo.DefaultValue属性检索默认值。如果不存在默认值,该属性将返回 Value.DBNull

    以下示例向控制台显示 MyMethod 的默认值。

    [Visual Basic]

    Dim m As MethodInfo = t.GetMethod("MyMethod")

    Dim ps As ParameterInfo() = m.GetParameters()

    Dim i As Integer

    For i = 0 To ps.Length - 1

        Console.WriteLine("Default Value == {0}", ps(i).DefaultValue)

    Next i

    [C#]

    MethodInfo m = t.GetMethod ("MyMethod");

    ParameterInfo[] ps = m.GetParameters();

    for (int i = 0; i < ps.Length; i++) {

        Console.WriteLine("Default Value == {0}", ps[i].DefaultValue);

    }

    要调用包含具有默认值的参数的方法,请使用 Type.Missing 作为 InvokeMember 方法的参数值。这样,晚期绑定服务就能够为指定的参数值使用默认值。如果为不带默认值的参数传递 Type.Missing,则将引发ArgumentException。有一点务必要注意,并非所有编译器的绑定机制都会遵守 Type.Missing 的这些规则。有些联编程序可能不支持此功能,或者可能以不同的方式来处理 Type.Missing。当使用 Type.Missing 时,默认值不必是结尾的参数值。

    C# 语言不支持默认参数。

    以下 Visual Basic .NET 示例显示如何调用具有默认参数的方法。

    [Visual Basic]

    Option Strict Off

    Imports System

    Imports System.Reflection

    Public Class OptionalArg

        Public Sub MyMethod (a As Integer, Optional b As Double = 1.2, Optional c As Integer=1)

            Console.WriteLine("a = " & a & " b = " & b & " c = " & c)

        End Sub

    End Class

    Module Module1

        Sub Main()

            Dim o As New OptionalArg

            Dim t As Type

            t = GetType(OptionalArg)

            Dim Param As Object()= {10, 20, 30}

            t.InvokeMember("MyMethod", _

                            BindingFlags.Public Or _

                            BindingFlags.Instance Or _

                            BindingFlags.InvokeMethod Or _

                            BindingFlags.OptionalParamBinding, _

                            Nothing, _

                            o, _

                            New Object() {10, 55.3, 12})

            t.InvokeMember("MyMethod", _

                            BindingFlags.Public Or _

                            BindingFlags.Instance Or _

                            BindingFlags.InvokeMethod Or _

                            BindingFlags.OptionalParamBinding, _

                            Nothing, _

                            o, _

                            New Object() {10, 1.3, Type.Missing})

            t.InvokeMember("MyMethod", _

                            BindingFlags.Public Or _

                            BindingFlags.Instance Or _

                            BindingFlags.InvokeMethod Or _

                            BindingFlags.OptionalParamBinding, _

                            Nothing, _

                            o, _

                            New Object() {10, Type.Missing, Type.Missing})

        End Sub

    End Module

    当使用上述方法时,即使调用方未指定任何值,仍会考虑尾部的默认参数。这是调用具有默认参数的方法时最常用的方式。

    如果是使用 MethodBase.Invoke 来调用方法,则需要显式指定哪些参数是默认值,指定的方法是为所有没有值的参数传递一个包含 Type.Missing 的对象数组。

     

    可以看到,如果在不支持默认参数的语言中调用使用默认参数的函数会相当的复杂,因此,虽然在VB.NETCLS中允许使用默认参数,但是,微软并不推荐用户使用默认参数。在FxCop的设计规则中的第11条实现的对默认参数的检查。

    原文引用:

    Default parameters should not be used

    TypeName:

    DefaultParametersShouldNotBeUsed

    CheckId:

    CA1026

    Category:

    Microsoft.Design

    Message Level:

    Error

    Certainty:

    75%

    Breaking Change:

    Breaking


    Cause: An externally visible type contains an externally visible method that uses a default parameter.

    Rule Description

    Methods that use default parameters are allowed under the Common Language Specification (CLS); however, the CLS allows compilers to ignore the values assigned to these parameters. Code written for compilers that ignore default parameter values must explicitly provide arguments for each default parameter. To maintain the behavior that you want across programming languages, methods that use default parameters should be replaced with method overloads that provide the default parameters.

    The C# compiler ignores the values of default parameters as does the Managed C++ compiler when accessing managed code. The Visual Basic compiler supports methods with default parameters using the Optional keyword.

    How to Fix Violations

    To fix a violation of this rule, replace the method that uses default parameters with method overloads that supply the default parameters.

    When to Exclude Messages

    Do not exclude a message from this rule.

    Example Code

    The following example shows a method that uses default parameters, and the overloaded methods that provide an equivalent functionality.

    [Visual Basic]

    Imports System

     

    <Assembly: CLSCompliant(True)>

    Namespace DesignLibrary

     

        Public Class DefaultVersusOverloaded

     

            Sub DefaultParameters(Optional parameter1 As Integer = 1, _

                                  Optional parameter2 As Integer = 5)

                ' ...

                Console.WriteLine("{0} : {1}", parameter1, parameter2)

            End Sub

     

            Sub OverloadedMethod()

                OverloadedMethod(1, 5)

            End Sub

     

            Sub OverloadedMethod(parameter1 As Integer)

                OverloadedMethod(parameter1, 5)

            End Sub

     

            Sub OverloadedMethod(parameter1 As Integer, parameter2 As Integer)

                ' ...

                Console.WriteLine("{0} : {1}", parameter1, parameter2)

            End Sub

     

        End Class

     

    End Namespace

    Related Rules

    Replace repetitive arguments with params array

    See Also

    Method Usage Guidelines | Common Language Specification

    引起的原因:

    一个公共的visible, 想不出怎么翻译,翻译成可见的似乎很拗口。)类型包含一个公共的或保护的visible方法,这个方法使用了默认参数。

    描述:

    在公共语言规范(CLS)中允许使用默认参数,它允许编译器不指定值到这些参数。在不支持默认参数的编译器中,就必须明确的为每个参数指定值。如果希望在不同编程语言中可以使用相同的方法调用这个函数,应该使用重载函数替换使用默认参数的函数。

     

    C#编译器不支持默认参数,托管C++编译器在访问托管代码时也不支持默认参数,Visual Basic编译器通过关键字“Optional”支持默认参数。

    修复:

    使用多个重载函数替换使用默认参数的函数。

    例外:

    例程

    原文中的例子中包含两组方法,一个方法使用了默认参数,另外一组方法使用一组重载方法提供了同样的功能。

  • 相关阅读:
    迭代平方根
    windows怎么进如debug调试
    wxwidgets安装环境配置
    【android官方文档】与其他App交互
    Android ImageView图片自适应
    Gridview的stretchMode详解附自动宽度
    Activity生命周期解说
    一些问题
    android 文件读取(assets)
    android:scaleType属性
  • 原文地址:https://www.cnblogs.com/niaowo/p/3818574.html
Copyright © 2011-2022 走看看