using System;

namespace Smdn.Utils {
  /// <summary>文字列操作に関するユーティリティメソッドを提供するクラスです。</summary>
  /// <remarks>このクラスは静的クラスです。　インスタンスを作成することは出来ません。</remarks>
  public static class StringUtils {
    /// <summary>文字列の並びを逆転した結果を返します。</summary>
    /// <remarks><paramref name="str"/>の長さが0の場合、長さ0の<see cref="System.String"/>を返します。</remarks>
    /// <param name="str">並びを逆転する<see cref="System.String"/>を指定します。</param>
    /// <returns>並びを逆転した<see cref="System.String"/>を返します。</returns>
    /// <exception cref="ArgumentNullException"><paramref name="str"/>がnullの場合にスローされます。</exception>
    /// <example>
    /// 次のコードでは、変数<c>foo</c>に文字列<c>"oof"</c>が代入されます。
    /// <code>
    /// string foo = StringUtils.Reverse("foo");
    /// </code>
    /// </example>
    public static string Reverse(string str)
    {
      if (str == null) throw new ArgumentNullException("str");

      char[] chars = str.ToCharArray();

      Array.Reverse(chars);

      return new string(chars);
    }

    /// <summary>文字列を全角および半角の空白で区切った結果を<see cref="System.String"/>の配列で返します。</summary>
    /// <remarks><paramref name="str"/>の長さが0の場合、長さ0の<see cref="System.String"/>配列を返します。</remarks>
    /// <param name="str">分割する<see cref="System.String"/>を指定します。</param>
    /// <returns>文字列を全角および半角の空白で区切った<see cref="System.String"/>の配列を返します。</returns>
    /// <exception cref="ArgumentNullException"><paramref name="str"/>がnullの場合にスローされます。</exception>
    public static string[] SplitBySpace(string str)
    {
      if (str == null) throw new ArgumentNullException("str");

      return str.Split(new char[] {' ', '　'}, StringSplitOptions.None);
    }
  }
}

<?xml version="1.0"?>
<doc>
    <assembly>
        <name>Smdn.Utils</name>
    </assembly>
    <members>
        <member name="T:Smdn.Utils.StringUtils">
            <summary>文字列操作に関するユーティリティメソッドを提供するクラスです。</summary>
            <remarks>このクラスは静的クラスです。　インスタンスを作成することは出来ません。</remarks>
        </member>
        <member name="M:Smdn.Utils.StringUtils.Reverse(System.String)">
            <summary>文字列の並びを逆転した結果を返します。</summary>
            <remarks><paramref name="str"/>の長さが0の場合、長さ0の<see cref="T:System.String"/>を返します。</remarks>
            <param name="str">並びを逆転する<see cref="T:System.String"/>を指定します。</param>
            <returns>並びを逆転した<see cref="T:System.String"/>を返します。</returns>
            <exception cref="T:System.ArgumentNullException"><paramref name="str"/>がnullの場合にスローされます。</exception>
            <example>
            次のコードでは、変数<c>foo</c>に文字列<c>"oof"</c>が代入されます。
            <code>
            string foo = StringUtils.Reverse("foo");
            </code>
            </example>
        </member>
        <member name="M:Smdn.Utils.StringUtils.SplitBySpace(System.String)">
            <summary>文字列を全角および半角の空白で区切った結果を<see cref="T:System.String"/>の配列で返します。</summary>
            <remarks><paramref name="str"/>の長さが0の場合、長さ0の<see cref="T:System.String"/>配列を返します。</remarks>
            <param name="str">分割する<see cref="T:System.String"/>を指定します。</param>
            <returns>文字列を全角および半角の空白で区切った<see cref="T:System.String"/>の配列を返します。</returns>
            <exception cref="T:System.ArgumentNullException"><paramref name="str"/>がnullの場合にスローされます。</exception>
        </member>
    </members>
</doc>

using System;
using System.Collections.Generic;

namespace SampleNamespace {
  struct Structure1 {
    int Field;
  }

  class Class1 {
    /// <example>
    /// 同一型内のメンバの場合は、クラス名を省略して<see cref="Field"/>や<see cref="Method"/>のように記述できる
    /// 異なる型のメンバの場合は、<see cref="Structure1.Field"/>のように型名から記述する必要がある
    /// </example>
    public int Field = 0;
    public void Method() {}

    /// <example>
    /// オーバーロードされたメソッドを限定する場合は、<see cref="Method1()"/>、
    /// <see cref="Method1(int)"/>、<see cref="Method1(int,int)"/>のように引数リストを記述する必要がある
    /// </example>
    public void Method1() {}
    public void Method1(int x) {}
    public void Method1(int x, int y) {}

    /// <example>
    /// 引数が配列やref/outパラメータの場合は、
    /// <see cref="Method1(int[,])"/>、<see cref="Method1(ref int)"/>のように記述する
    /// </example>
    public void Method1(int[,] x) {}
    public void Method1(ref int x) {}

    /// <example>
    /// コンストラクタを参照する場合は、<see cref="Class1()"/>、<see cref="Class1(int)"/>のように
    /// 「型名(引数リスト)」と記述する
    /// </example>
    public Class1() {}
    public Class1(int x) {}
  }

  /// <example>
  /// ジェネリック型・ジェネリックメソッドを参照する場合、
  /// 山カッコを文字参照に置き換えて<see cref="List&lt;T&gt;.Add"/>のように記述するか、
  /// 山カッコを波カッコに置き換えて<see cref="List{T}.Add"/>のように記述する必要がある
  /// <see cref="List{THoge}.Add"/>のように型パラメータ名が異なっていても、型パラメータの数が一致すれば適切に参照される
  /// </example>
  class Class2 {
    /// <exception cref="ArgumentException">インポートされた名前空間にある型は名前空間を記述しなくてもよい</exception>
    /// <exception cref="System.ComponentModel.InvalidEnumArgumentException">
    /// インポートされていない名前空間にある型は、完全限定名を記述する必要がある
    /// </exception>
    /// <remarks>実際にはスローされない例外がcref属性に記述されていてもエラーとはならない</remarks>
    public void ThrowsExceptionMethod()
    {
    }
  }

  /// <example>
  /// インポートされていない場合に完全限定名を記述するのは、型だけでなくメンバの場合も同様
  /// <see cref="OtherNamespace.Class5.Field5"/>
  /// </example>
  class Class3 {
    protected void Method3() {}
  }

  /// <example>
  /// 基底クラスのメンバを参照する場合は、<see cref="Class3.Method3()"/>のように型名から記述する必要がある
  /// </example>
  class Class4 : Class3 {
  }
}

namespace OtherNamespace {
  class Class5 {
    public static readonly int Field5 = 16;
  }
}

using System;
using System.Collections.Generic;

/// <example>
///  CDATAセクションを使った<see cref="List{T}"/>のサンプルコード記述例です。
///  <code><![CDATA[
///    var list = new List<string>();
///
///    list.Add("foo");
///    list.Add("bar");
///
///    if (0 < list.Count)
///      list.Add("baz");
///  ]]></code>
///  文字参照を使った<see cref="List{T}"/>のサンプルコード記述例です。
///  <code>
///    var list = new List&lt;string&gt;();
///
///    list.Add("foo");
///    list.Add("bar");
///
///    if (0 &lt; list.Count)
///      list.Add("baz");
///  </code>
/// </example>
class Class1 {}

<member name="T:Class1">
     <example>
      CDATAセクションを使った<see cref="T:System.Collections.Generic.List`1"/>のサンプルコード記述例です。
      <code><![CDATA[
        var list = new List<string>();
    
        list.Add("foo");
        list.Add("bar");
    
        if (0 < list.Count)
          list.Add("baz");
      ]]></code>
      文字参照を使った<see cref="T:System.Collections.Generic.List`1"/>のサンプルコード記述例です。
      <code>
        var list = new List&lt;string&gt;();
    
        list.Add("foo");
        list.Add("bar");
    
        if (0 &lt; list.Count)
          list.Add("baz");
      </code>
     </example>
</member>

<?xml version="1.0"?>
<MathUtils>
  <Max>
    <summary>引数で与えられた3つの値のうち、最大のものを返します。</summary>
    <param name="x">比較する3つの値のうち、1つ目の値。</param>
    <param name="y">比較する3つの値のうち、2つ目の値。</param>
    <param name="z">比較する3つの値のうち、3つ目の値。</param>
  </Max>
</MathUtils>

<?xml version="1.0"?>
<doc>
    <assembly>
        <name>test</name>
    </assembly>
    <members>
        <member name="M:MathUtils.Max(System.Int32,System.Int32,System.Int32)">
            <summary>引数で与えられた3つの値のうち、最大のものを返します。</summary>
            <param name="x">比較する3つの値のうち、1つ目の値。</param>
            <param name="y">比較する3つの値のうち、2つ目の値。</param>
            <param name="z">比較する3つの値のうち、3つ目の値。</param>
            <returns>引数で与えられた3つの<see cref="T:System.Int32" />のうち、最大のものを返します。</returns>
        </member>
        <member name="M:MathUtils.Max(System.Int64,System.Int64,System.Int64)">
            <summary>引数で与えられた3つの値のうち、最大のものを返します。</summary>
            <param name="x">比較する3つの値のうち、1つ目の値。</param>
            <param name="y">比較する3つの値のうち、2つ目の値。</param>
            <param name="z">比較する3つの値のうち、3つ目の値。</param>
            <returns>引数で与えられた3つの<see cref="T:System.Int64" />のうち、最大のものを返します。</returns>
        </member>
        <member name="M:MathUtils.Max(System.Double,System.Double,System.Double)">
            <summary>引数で与えられた3つの値のうち、最大のものを返します。</summary>
            <param name="x">比較する3つの値のうち、1つ目の値。</param>
            <param name="y">比較する3つの値のうち、2つ目の値。</param>
            <param name="z">比較する3つの値のうち、3つ目の値。</param>
            <returns>引数で与えられた3つの<see cref="T:System.Double" />のうち、最大のものを返します。</returns>
        </member>
    </members>
</doc>

/// <summary xml:lang="ja">1つめ<see cref="T:System.String"/></summary>
/// <summary>2つめ<see cref="T:System.String" x:version="netfx2.0" xmlns:x="http://example.com/ns/extensions"/></summary>
/// <summary xml:lang="en">3rd<see cref="T:System.String"/></summary>
/// <remarks>
/// XHTMLの要素を使って説明を記述する例です。
/// <div xmlns="http://www.w3.org/1999/xhtml">
///   <h1>メソッドの動作</h1>
///   <p>メソッドの動作をフローチャートで表すと次のようになります。
///     <img src="flowchart.png" alt="フローチャート" />
///   </p>
/// </div>
/// </remarks>
class XmlDocumentExtension {}

<?xml version="1.0"?>
<doc>
    <assembly>
        <name>XmlDocumentExtension</name>
    </assembly>
    <members>
        <member name="T:XmlDocumentExtension">
            <summary xml:lang="ja">1つめ<see cref="T:System.String"/></summary>
            <summary>2つめ<see cref="T:System.String" x:version="netfx2.0" xmlns:x="http://example.com/ns/extensions"/></summary>
            <summary xml:lang="en">3rd<see cref="T:System.String"/></summary>
            <remarks>
            XHTMLの要素を使って説明を記述する例です。
            <div xmlns="http://www.w3.org/1999/xhtml">
              <h1>メソッドの動作</h1>
              <p>メソッドの動作をフローチャートで表すと次のようになります。
                <img src="flowchart.png" alt="フローチャート" />
              </p>
            </div>
            </remarks>
        </member>
    </members>
</doc>

    ︙
  <PropertyGroup>
      ︙
    <!-- コンパイラの出力先ディレクトリ -->
    <OutputPath>bin\Debug</OutputPath>

    <!--
      XMLドキュメントを生成し、ファイル名sample.xmlで出力する
      出力先はOutputPathプロパティで指定されるディレクトリとなる(exe/dllファイルと同じ出力先)
    -->
    <DocumentationFile>sample.xml</DocumentationFile>

    <!-- アセンブリ名(AssemblyNameプロパティの値)を展開してファイル名とする場合は次のようにする -->
    <DocumentationFile>$(AssemblyName).xml</DocumentationFile>
      ︙
  </PropertyGroup>
    ︙

using System;

namespace Smdn.Utils {
#if DOCLANG_JA
  /// <summary>文字列操作に関するユーティリティメソッドを提供するクラスです。</summary>
#else
  /// <summary>The StringUtils class provides string-related utility methods.</summary>
#endif
  public static class StringUtils {}
}

csc StringUtils.cs /out:Smdn.Utils.dll /target:library /doc:Smdn.Utils.xml

<?xml version="1.0"?>
<doc>
    <assembly>
        <name>Smdn.Utils</name>
    </assembly>
    <members>
        <member name="T:Smdn.Utils.StringUtils">
            <summary>The StringUtils class provides string-related utility methods.</summary>
        </member>
    </members>
</doc>

csc StringUtils.cs /out:Smdn.Utils.dll /target:library /define:DOCLANG_JA /doc:Smdn.Utils.xml

<?xml version="1.0"?>
<doc>
    <assembly>
        <name>Smdn.Utils</name>
    </assembly>
    <members>
        <member name="T:Smdn.Utils.StringUtils">
            <summary>文字列操作に関するユーティリティメソッドを提供するクラスです。</summary>
        </member>
    </members>
</doc>

using System;

namespace Smdn.Utils {
  /// <summary xml:lang="ja">文字列操作に関するユーティリティメソッドを提供するクラスです。</summary>
  /// <summary>The StringUtils class provides string-related utility methods.</summary>
  public static class StringUtils {
    /// <summary>The Method1</summary>
    /// <summary xml:lang="ja">メソッド1</summary>
    public static void Method1()
    {
    }

    /// <summary>The Method2</summary>
    public static void Method2()
    {
    }
  }
}

<?xml version="1.0"?>
<doc>
    <assembly>
        <name>Smdn.Utils</name>
    </assembly>
    <members>
        <member name="T:Smdn.Utils.StringUtils">
            <summary xml:lang="ja">文字列操作に関するユーティリティメソッドを提供するクラスです。</summary>
            <summary>The StringUtils class provides string-related utility methods.</summary>
        </member>
        <member name="M:Smdn.Utils.StringUtils.Method1">
            <summary>The Method1</summary>
            <summary xml:lang="ja">メソッド1</summary>
        </member>
        <member name="M:Smdn.Utils.StringUtils.Method2">
            <summary>The Method2</summary>
        </member>
    </members>
</doc>

using System;
using System.Collections.Generic;
using System.Xml;

public class XmlLangFilter {
  static void Main(string[] args)
  {
    // 第一引数で与えられたXMLファイルを読み込む
    var document = new XmlDocument();

    document.Load(args[0]);

    // 第二引数で与えられるxml:langの値にしたがって要素をフィルタリングする
    var filterLang = 2 <= args.Length ? args[1] : string.Empty;

    // 全ての/doc/members/member要素について、引数で与えられたxml:langの値を持つ要素だけをフィルタリングする
    foreach (XmlElement memberElement in document.SelectNodes("/doc/members/member")) {
      // member下の要素名と要素のXmlElementを格納するDictionary
      var langElement = new Dictionary<string, XmlElement>();
      // member下の全てのXmlElementを格納するList
      var elements = new List<XmlElement>();

      // menber要素のすべての子要素を列挙
      foreach (XmlElement element in memberElement.ChildNodes) {
        elements.Add(element);

        // 要素名を取得
        var name = element.Name;
        // xml:lang属性の値を取得
        var lang = element.GetAttribute("xml:lang");

        // xml:lang属性を削除する
        element.RemoveAttribute("xml:lang");

        if (langElement.ContainsKey(name)) {
          // すでにDictionaryに同名の要素が格納されている場合、
          // xml:langが目的の値を持つ場合に限り上書きする
          if (lang == filterLang)
            langElement[name] = element;
        }
        else {
          langElement[name] = element;
        }
      }

      // 一旦member要素のすべての子要素を削除する
      foreach (var element in elements) {
        memberElement.RemoveChild(element);
      }

      // フィルタリングした要素だけを追加する
      foreach (var element in langElement.Values) {
        memberElement.AppendChild(element);
      }
    }

    // フィルタリングしたXMLドキュメントを標準出力に書き出す
    var writerSettings = new XmlWriterSettings();

    writerSettings.Indent = true;
    writerSettings.IndentChars = "    ";

    var writer = XmlWriter.Create(Console.OpenStandardOutput(), writerSettings);

    document.Save(writer);
  }
}

XmlLangFilter.exe input.xml

<?xml version="1.0"?>
<doc>
    <assembly>
        <name>Smdn.Utils</name>
    </assembly>
    <members>
        <member name="T:Smdn.Utils.StringUtils">
            <summary>The StringUtils class provides string-related utility methods.</summary>
        </member>
        <member name="M:Smdn.Utils.StringUtils.Method1">
            <summary>The Method1</summary>
        </member>
        <member name="M:Smdn.Utils.StringUtils.Method2">
            <summary>The Method2</summary>
        </member>
    </members>
</doc>

XmlLangFilter.exe input.xml ja

<?xml version="1.0"?>
<doc>
    <assembly>
        <name>Smdn.Utils</name>
    </assembly>
    <members>
        <member name="T:Smdn.Utils.StringUtils">
            <summary>文字列操作に関するユーティリティメソッドを提供するクラスです。</summary>
        </member>
        <member name="M:Smdn.Utils.StringUtils.Method1">
            <summary>メソッド1</summary>
        </member>
        <member name="M:Smdn.Utils.StringUtils.Method2">
            <summary>The Method2</summary>
        </member>
    </members>
</doc>