أمر التفريق

يقارن, و إذا كان من الممكن عرض الاختلافات بين ملفين ، ملفات في مجلدين, أو shelveset وملف محلي أو ملف خادم.

الأذونات المطلوبة.

لاستخدام أمر difference يجب أن يكون لديك مجموعة الأذونات المقرؤة الخاصة بكافة العناصر المحددة معينة الي السماح. لمزيد من المعلومات، راجع أذونات خادم أساس الفريق.

tf diff[erence] itemspec [/version:versionspec] [/type:filetype] 
[/format:format [/ignorespace] [/ignoreeol] [/ignorecase] [/recursive] 
[/options]

tf diff[erence] itemspec itemspec2 [/type:filetype] [/format: format] 
[/ignorespace] [/ignoreeol] [/ignorecase] [/recursive] [/options]

tf diff[erence] [/shelveset:shelvesetname[;shelvesetowner]] 
shelveset_itemspec [/server: servername] [/type:filetype] 
[/format: format] [/ignorespace] [/ignoreeol] [/ignorecase] 
[/recursive] [/options]

tf diff[erence] /configure

المعلمات

الوسيطة	الوصف
itemspec	مطلوبة. تحدد العنصر لمقارنته. إذا لم يتم تحديد عدم إصدار أو مسار , إصدار مساحة العمل يتم افتراضه . يقبل كلا المسارين الخاصين بالملقم المحلي و التحكم بالإصدار Team Foundation . للحصول على مزيد من المعلومات حول كيفية تحليل Team Foundation لمواصفات العناصر (itemspecs) لتحديد العناصر التي كانت داخل النطاق, راجع بناء جملة سطر الأوامر (التحكم بالإصدار). لا يدعم الأمرdifference أحرف البدل. لا يمكن تجميع هذا العامل مع الخيار /shelveset.
Itemspec2	اختياري. العنصر الذي يتم مقارنته ب itemspec . إذا لم توفر I temspec ثانية ، يتم استخدام أحدث اصدار التحكم بالإصدار Team Foundation للملقم خاص بالعنصر.
Filetype	توفر قيمة للخيار /type. يمكنك تحديد "كلمة ثنائي" أو "نص ،" و رقم مخطط الشفرة أو اسم مألوف لصفحة الترميز اللغوي.
Format	يستخدم مع لخيار /format ا لتحديد تنسيق إخراج إلى أحد الأنواع التالية: المرئي مختصرة Context rcs ss SS_SideBySide SS_Unix الموحدة UNIX يتم توضيح هذه التنسيقات إخراجات في المقطع "ملاحظات" الخاص بهذا الموضوع.
Versionspec	القيمة الموفرة بواسطة المستخدم للخيار /version . للحصول على مزيد من المعلومات حول كيفية قيام Team Foundation بتحليل مواصفات الإصدار لتحديد أي من العناصر داخل النطاق الخاص به, راجع بناء جملة سطر الأوامر (التحكم بالإصدار).
servername	القيمة الموفرة بواسطة المستخدم للخيار /server . مثال: teamfoundation2.
Shelvesetowner	يعرّف مالك shelveset بواسطة اسم المستخدم . إذا لم يتم توفير قيمة هذا العامل يتم افتراض المستخدم الحالي.
Shelvesetname	تحدد اسم shelveset. لاحظ أنه يمكن أن يكون هناك shelveset واحد أو أكثر لهم نفس الاسم على Team Foundation Server طالما أن كل مملوك من قبل مستخدم مختلف.
Shelveset_itemspec	تعيّن اسم ملف أو مجلد في shelveset لمقارنته بإصدار shelveset الأساسي.

الخيار	الوصف
/type	يتجاوز أي ترميز تم الكشف عنه ويستخدم الترميز المحدد لتقديم الملفات للمشغّل differencing.
/version	تحديد إصدار الملف أو المجلد للمقارنة. ، افتراضيا يستخدم Team Foundation إصدار مساحة العمل إذا لم توفر versionspec. بدلاً من استخدام إشارة /version ، يمكنك تعيين الإصدارات بإلحاق الفاصلة المنقوطة و محدد الإصدار لنهاية كل اسم ملف.
/format	تحدد تنسيق الخارج المحدد بواسطة الوسيطة format .
/ignorespace	لا يقوم بتسليط الضوء علي الاختلافات في المسافات البيضاء بين الملفات التي تمت مقارنتها.
/ignoreeol	تتجاهل اختلافات بين أحرف السطر الجديد في ملفي أو إصدارات الملفات. /ignoreeolيعمل بشكل مختلف عن/ignoreSpace. /ignorespaceيعامل المسافات ثمانية المثل إلى واحد. ومع ذلك، إذا استخدمت الخيار /ignoreeol و الملف A يحتوي علي حرفين سطر جديد بين نواحي بدون تغيير في النص، و ملف B يحتوي على واحد تعرض النتائج على أنها مختلفة. إذا كان لدي الملفين سطر جديد واحد فقط ولكن ملف A \r\n كسطر جديد و ملف B يستخدم خيار\n ، /ignoreEOL يتم تجاهله كـفرق.
/ignorecase	لا يتم تسليط الضوء علي الاختلاف في استخدام الاحرف الكبيرة او الصغيرة عند مقارنة الملفات.
/recursive	يقارن الاختلافات بين المجلد الحالي والمجلدات الفرعية التابعة له.
/options	تعين سلسلة خيار ل إلى ol إلى يتم استدعاؤه بواسطة diff. للمزيد من المعلومات، راجع كيفية: إقران نوع ملف أداة الفرق وكيفية: إقران نوع ملف أداة دمج.
/server	يعرّف الـ Team Foundation Server. هذا الخيار مطلوب إذا تم استدعاء الأمر من دليل غير معين لمساحة العمل.
/shelveset	تحديد shelveset لمقارنته بإصدار الملقم التحكم بالإصدار Team Foundation الذي يعتمد علىه ال shelveset. لا يمكن ضم هذا الخيار بالوسيطة itemspec . لمقارنة عناصر shelveset فردية ، يمكنك توفير shelveset_itemspec.
/noprompt	منع أية مربعات حوار يمكن عرضها أثناء إكمال هذه العملية.
/configure	استدعاء مربع الحوار أدوات تكوين المستخدم. هذه الأداة متوفرة من واجهة المستخدم Visual Studio . لمزيد من المعلومات، راجع كيفية: إقران نوع ملف أداة الفرق.

ملاحظات

ملاحظة

يمكنك كتابة tf diff أو tf difference في سطر الأوامر لتشغيل هذا الأمر.

يمكنك استخدام الأمرdifference للمقارنة و إذا كان ممكناً عرض الاختلافات بين:

• ملفين مختلفين أو إصدارين من نفس الملف.

• لواحد أو أكثر من العناصر في مجلد

• واحد أو بعض أو كافة العناصر في shelveset على Team Foundation Server.

يمكنك استخدام الأمر difference لمقارنة كل من الملفات المنسوخة و غير المنسوخة.

Team Foundation تقوم بتصنيف كافة الملفات بواسطة النوع. يمكن دمج وإعادة مقارنة ملفات النص جنباً إلى جنب سطراً سطراً طالما لدي الملفين نفس الترميز. إذا كنت تريد مقارنة ملفين ليس لديهم نفس الترميز ، يمكنك بشكل مؤقت قناع أو تجاوز خاصية ترميز الملف باستخدام الخيار**/type** . يمكن مقارنة المافات الثنائية صواب ولكن لا يمكن دمجها. عند تمرير واحد أو أكثر من الملفات الثنائية الي أمر التفريق ، يشير Team Foundation إلى ما إذا كانت الاختلافات موجودة بينه و بين العنصر الذي يتم مقارنته. للحصول على مزيد من المعلومات حول كيف يقوم Team Foundation بالتمييز بين ملفات منفصلة و كيف يتعامل معهم ، راجع أنواع إدارة الملف.

إذا قمت بتحديد أسماء ملفين تتم مقارنتهم. بدلاً من استخدام إشارة /version ، يمكنك تعيين الإصدارات بإلحاق الفاصلة المنقوطة و محدد الإصدار لنهاية كل اسم ملف.

إذا قمت بتمرير itemspec واحد فقط الي أمر التفريق:

• إذا لم توفر versionspec ، إصدار مساحة العمل الخاص بك من العنصر يتم مقارنته إلى الإصدار الأساسي لمساحة العمل بشكل افتراضي. على سبيل المثال، يقارنtf difference header.h الإصدار الحالي ل header.h إلى الإصدار الذي يعتمد عليه header.h.

• إذا قمت بتضمين versionspec في itemspec مثل, يقارن tf difference header.h;LBeta1 ، Team Foundation ذلك الإصدار إلى إصدار مساحة العمل الحالي على القرص.

• إذا قمت بتحديد نطاق الإصدارات مثل /version:C1~C4 ، تتم مقارنة إصدارات الملف علي نقطتي النهاية من النطاق.

للحصول على مزيد من المعلومات حول كيفية العثور على أداة سطر الأوامر TF، راجع TF أداة سطر أوامر.

أنواع تنسيق الانتاج

العاملformat الذي يستخدم مع الخيار**/format** ، يحدد العديد من التنسيقات المختلفة للناتج. أنواع الإخراج المتوفرة

• Visual

  نوع التنسيق Visual يفتح تطبيق فرق خارجي. يتم تشغيل diffmerge.exe بشكل افتراضي.

• Brief

  تنسيق موجز طباعة ما إذا كانت تختلف الملفات التي تتم مقارنتها.

• Context

  يوفر التنسيقContext خطوط سياق الاختلافات في الملفات. هذا التنسيق مشتق من ضيغة الإخراج diff –c المبنية على الـ UNIX

• RCS

  يشبه تنسيق RCS ال**/format:unix** ، فيما عدا ان خطوط السياق غير متوفرة.

  لا يتم توفير تسليم خاص لطرف مفقود لعلامة سطر في نهاية الملف.

• SS

  التنسيق الافتراضي لـVisual SourceSafe هو SS. للحصول على المزيد من المعلومات, راجع موقع Microsoft على "ويب"https://go.microsoft.com/fwlink/?LinkId=99139.

• SS_SideBySide

  SS_SideBySide هو تنسيق الناتج الافتراضي جنباً إلى جنب ل Visual SourceSafe.

• SS_Unix

  يشبه SS_Unix /format:unix تنسيق ولكن /format:ss_unix يحتوي علي أسطر سياق و /format:unix لا يحتوي عليها .

• Unified

  Unified format is derived from the UNIX based diff –u output format. /format:contextتكرار خطوط سياق متطابقة بين السلاسل الفرق على الرغم من أن**/format:unified**هل عدم.

  التنسيقUnified يعطي سلسلة فرق جديدة موحدة (@@... سطر @) فقط عندما تكون المسافة الي سلسلة الفرق التالي أكبر من عدد أسطر السياق.

• Unix

  نوع الناتج هذا مشتق من أمر تنسيق الناتج diff المستند إلى UNIX .

  إنشاء تنسيق الإخراجUnix بالطريقة التالية:

  <metadataline>
  "< " line prefix for lines from the first file
  "---" line
  "> " line prefix for lines from the second file
  
  <metadataline> can be one of these possibilities:
  #a#,# -- add lines from line # in file1 into file2 at lines #->#
  #,#d# -- delete lines from line # -> # in file 1 from file2 at line #
  #,#c#,# -- change lines from line # -> # in file1 into the lines in file2 at line # -> #
  
  # signs seprated by commas indicate a line range.
  # signs before the character indicate line numbers in the first file
  # signs after the character indidicate line numbers in the second file
  
  /// No end of line marker at the end of the file:
  /// \ No newline at end of file
  

أمثلة

يعرض المثال التالي الاختلافات بين الاصدار المحلي ل 314. cs و اصدار مساحة العمل من cs 314. التي هي اصدار الملف الذي تم سحبه من الملقم التحكم بالإصدار Team Foundation.

c:\projects>tf difference 314.cs

يعرض المثال التالي كل الملفات التي تم تغييرها في المجلد الرئيسي . لا تقوم بعرض الملفات التي تم تغييرها في المجلدات الفرعية ل src.

c:\projects>tf difference src /format:visual

يعرض المثال التالي الاختلافات بين changeset 3 وchangeset 8 من 1254.cs.

c:\projects>tf difference /version:C3~C8 1254.cs

تعرض الأمثلة التالية الاختلافات بين إصدار cs 314. التي تنتمي الي تسمية "الإصدار" والإصدار الذي ينتمي الي changeset 3200.

c:\projects>tf difference 314.cs;Lrelease 314.cs;C3200

—أو—

c:\projects>tf difference 314.cs;Lrelease~C3200

يعرض المثال التالي الفرق بين إصدارات e271.cs shelved حيث مستخدم باسم نادية قام بوضعها في shelveset PeerCodeReview8 و الإصدار الأساسي shelveset الذي هو الإصدار الذي اعتمدت عليه في التغييرات الخاصة به. تعرض أيضاً أنواع التغييرات المعلقة مقابل e271.cs عندما قامت نادية بوضعها علي الرف.

c:\projects> tf difference /shelveset:PeerCodeReview8;Nadia e271.cs

يعرض المثال التالي الاختلافات بين كل الملفات في shelveset PeerCodeReview2 و إصدار shelveset الأساسي من تلك الملفات.

c:\projects> tf difference /shelveset:PeerCodeReview2

راجع أيضًا:

المرجع

دمج الأوامر

أمر الإيداع

أوامر مجموعة التغييرات

المبادئ

أنواع إدارة الملف

موارد أخرى

TF أداة سطر أوامر

مقارنة المجلدات والملفات