|
1 | | -C# Driver Version 1.8.1 Release Notes |
2 | | -===================================== |
| 1 | +C#/.NET Driver Version 1.8.1 Release Notes |
| 2 | +========================================== |
| 3 | + |
| 4 | +This is a minor release. It should be considered a mandatory upgrade from 1.8. The |
| 5 | +issues fixed were minor changes but their impact is not minor. In particular, if |
| 6 | +you are using replica sets or are using InsertBatch with very large batches you |
| 7 | +should consider 1.8.1 a mandatory upgrade. |
| 8 | + |
| 9 | +An online version of these release notes is available at: |
| 10 | + |
| 11 | +https://github.com/mongodb/mongo-csharp-driver/blob/master/Release%20Notes/Release%20Notes%20v1.8.1.md |
| 12 | + |
| 13 | +File by file change logs are available at: |
| 14 | + |
| 15 | +https://github.com/mongodb/mongo-csharp-driver/blob/master/Release%20Notes/Change%20Log%20v1.8.1-Bson.txt |
| 16 | +https://github.com/mongodb/mongo-csharp-driver/blob/master/Release%20Notes/Change%20Log%20v1.8.1-Driver.txt |
| 17 | + |
| 18 | +The full list of JIRA issues resolved in this release is available at: |
| 19 | + |
| 20 | +https://jira.mongodb.org/secure/IssueNavigator.jspa?mode=hide&requestId=13252 |
| 21 | + |
| 22 | +Documentation on the C#/.NET driver can be found at: |
| 23 | + |
| 24 | +http://www.mongodb.org/display/DOCS/CSharp+Language+Center |
| 25 | +http://api.mongodb.org/csharp/current/ |
| 26 | + |
| 27 | +BSON Library Changes |
| 28 | +==================== |
| 29 | + |
| 30 | +Handling of closed sockets |
| 31 | +-------------------------- |
| 32 | + |
| 33 | +There was an unfortunate regression in 1.8 with respect to sockets closed by the |
| 34 | +server which causes the driver to hang waiting for data that is never going to |
| 35 | +arrive. |
| 36 | + |
| 37 | +This was discovered by a user who called Shutdown (which of course resulted in |
| 38 | +all sockets being closed), but you could also encounter this issue if |
| 39 | +you are connecting to replica sets and the primary closes all sockets when it |
| 40 | +steps down (either due to an explicit step down or a re-election). |
| 41 | + |
| 42 | +AscendingGuidGenerator |
| 43 | +---------------------- |
| 44 | + |
| 45 | +If you are using Guids as your _ids and you want the values to be ascending so |
| 46 | +that they are always inserted at the right hand side of the index you can use |
| 47 | +this IdGenerator. Note that for the server to see the Guids as ascending you |
| 48 | +have to make sure to store them in the right representation, which is |
| 49 | +GuidRepresentation.Standard. |
| 50 | + |
| 51 | +We used to recommend CombGuidGenerator for this use case, but we have since |
| 52 | +realized that the Guids generated by the CombGuid are only considered ascending |
| 53 | +when Guids are compared using SQL Server's method of comparing Guids. |
| 54 | + |
| 55 | +Driver Changes |
| 56 | +============== |
| 57 | + |
| 58 | +MongoCollection |
| 59 | +--------------- |
| 60 | + |
| 61 | +There is a new overload of Distinct which returns the values as TValue(s) |
| 62 | +instead of as BsonValue(s). |
| 63 | + |
| 64 | +There was a bug in InsertBatch that resulted in a high probability of |
| 65 | +InsertBatch failing if the batch was big enough to have to be split into |
| 66 | +multiple sub-batches. |
| 67 | + |
| 68 | +MongoDatabase |
| 69 | +------------- |
| 70 | + |
| 71 | +RunCommandAs now uses the standard serialization mechanisms to deserialize |
| 72 | +all command results returned from the server. |
0 commit comments