diff --git a/csharp/src/Google.Protobuf/Collections/MapField.cs b/csharp/src/Google.Protobuf/Collections/MapField.cs index 993a89d776..053f755850 100644 --- a/csharp/src/Google.Protobuf/Collections/MapField.cs +++ b/csharp/src/Google.Protobuf/Collections/MapField.cs @@ -48,9 +48,6 @@ namespace Google.Protobuf.Collections /// Value type in the map. Must be a type supported by Protocol Buffers. /// /// - /// This implementation preserves insertion order for simplicity of testing - /// code using maps fields. Overwriting an existing entry does not change the - /// position of that entry within the map. Equality is not order-sensitive. /// For string keys, the equality comparison is provided by . /// /// @@ -65,6 +62,10 @@ namespace Google.Protobuf.Collections /// supported by Protocol Buffers (e.g. using a key type of byte) but nor does it guarantee /// that all operations will work in such cases. /// + /// + /// The order in which entries are returned when iterating over this object is undefined, and may change + /// in future versions. + /// /// public sealed class MapField : IDeepCloneable>, IDictionary, IEquatable>, IDictionary {